hibernate/hibernate-orm · error · IllegalArgumentException

Named entity graph '

Error message

Named entity graph '

What it means

Error "Named entity graph '" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/internal/AbstractSharedSessionContract.java:763

			final var lockMode = LockMode.fromJpaLockMode( entityMapping.lockMode() );
			if ( lockMode.greaterThan( LockMode.READ ) ) {
				query.setHibernateLockMode( lockMode );
			}
		}
		return query;
	}

	@Override
	@Nonnull
	public <T> RootGraph<T> getEntityGraph(@Nonnull Class<T> entityClass, @Nonnull String name) {
		return castEntityGraph( entityClass, name, getEntityGraph( name ) );
	}

	private <T> RootGraph<T> castEntityGraph(Class<T> entityClass, String name, RootGraph<?> entityGraph) {
		final var type = getFactory().getJpaMetamodel().managedType( entityClass );
		final var graphedType = entityGraph.getGraphedType();
		if ( !Objects.equals( graphedType.getTypeName(), type.getTypeName() ) ) {
			throw new IllegalArgumentException( "Named entity graph '" + name
					+ "' is for type '" + graphedType.getTypeName() + "'" );
		}
		@SuppressWarnings("unchecked") // this cast is sound, because we just checked
		final var graph = (RootGraph<T>) entityGraph;
		return graph;
	}

	// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	// Shared builders

	@Override
	public SharedStatelessSessionBuilder statelessWithOptions() {
		checkSessionReentrancy();
		return new SharedStatelessSessionBuilderImpl( this ) {
			@Override
			protected StatelessSessionImplementor createStatelessSession(SharedStatelessOptions options) {
				return new StatelessSessionImpl( factory, options );
			}

View on GitHub (pinned to fad1729dce)

Solutions

1. Define the named entity graph with @NamedEntityGraph on an entity, or check the name for typos.

When it happens

Trigger: Thrown when looking up a named EntityGraph that is not defined for the persistence unit.

Common situations: Typical situations: misspelled graph name; missing @NamedEntityGraph on the entity; using a graph defined for a different entity.

AI-assisted analysis of hibernate/hibernate-orm@fad1729dce (2026-08-22). Data as JSON: /api/errors/b85e3ee818858bc9. Report an issue: GitHub.