hibernate/hibernate-orm · error · IllegalArgumentException

Not a managed type: ${typeName}

Error message

Not a managed type: ${typeName}

What it means

Error "Not a managed type: ${typeName}" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/metamodel/model/domain/internal/JpaMetamodelImpl.java:134

	public TypeConfiguration getTypeConfiguration() {
		return typeConfiguration;
	}

	public ServiceRegistry getServiceRegistry() {
		return serviceRegistry;
	}

	@Override
	public @Nullable ManagedDomainType<?> findManagedType(@Nullable String typeName) {
		return typeName == null ? null : managedTypeByName.get( typeName );
	}

	@Override
	@Nonnull
	public ManagedDomainType<?> managedType(@Nullable String typeName) {
		final var managedType = findManagedType( typeName );
		if ( managedType == null ) {
			throw new IllegalArgumentException( "Not a managed type: " + typeName );
		}
		return managedType;
	}

	@Override
	@Nullable
	public EntityDomainType<?> findEntityType(@Nullable String entityName) {
		if ( entityName == null ) {
			return null;
		}

		if ( managedTypeByName.get( entityName )
				instanceof EntityDomainType<?> entityDomainType ){
			return entityDomainType;
		}

		// NOTE: `managedTypeByName` is keyed by Hibernate entity name.
		// If there is a direct match based on key, we want that one - see above.

View on GitHub (pinned to fad1729dce)

Solutions

1. Pass a class that is a managed type (entity, mapped superclass, or embeddable) known to the persistence unit.
2. Ensure the class is listed in persistence.xml or scanned as part of the persistence unit.

When it happens

Trigger: Thrown when JpaMetamodel.managedType() is called with a class that is not a mapped entity, mapped superclass, or embeddable.

Common situations: See trigger scenarios.

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