mongodb/mongoid · error · Mongoid::Errors::InverseNotFound

When adding a(n) to # , Mongoid could not determine the…

Error message

When adding a(n) %{klass} to %{base}#%{name}, Mongoid could not determine the inverse foreign key to set. The attempted key was '%{inverse}'.

What it means

check_inverse! fires during (un)binding when the document being added is not bindable by the association: Mongoid cannot work out which inverse foreign key to populate. It signals a missing or unresolvable inverse on one side of the relation.

Solutions

1. Declare inverse_of explicitly on both sides of the association
2. Ensure the classes on both ends match what the association declarations describe

When it happens

Trigger: Thrown at lib/mongoid/association/bindable.rb:54 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of mongodb/mongoid@0da0e23d71 (2026-08-23). Data as JSON: /api/errors/c72fe80f7969828b. Report an issue: GitHub.

Appendix: source

Thrown at lib/mongoid/association/bindable.rb:54

        end
      end

      private

      # Check if the inverse is properly defined.
      #
      # @api private
      #
      # @example Check the inverse definition.
      #   binding.check_inverse!(doc)
      #
      # @param [ Document ] doc The document getting bound.
      #
      # @raise [ Errors::InverseNotFound ] If no inverse found.
      def check_inverse!(doc)
        return if _association.bindable?(doc)

        raise Errors::InverseNotFound.new(
          _base.class,
          _association.name,
          doc.class,
          _association.foreign_key
        )
      end

      # Remove the associated document from the inverse's association.
      #
      # @param [ Document ] doc The document to remove.
      def remove_associated(doc)
        return unless inverse = _association.inverse(doc)

        if _association.many?
          remove_associated_many(doc, inverse)
        elsif _association.in_to?
          remove_associated_in_to(doc, inverse)
        end

View on GitHub (pinned to 0da0e23d71)