hibernate/hibernate-orm · error · IllegalArgumentException

Couldn't find PropertyData for [<propertyName>] in class: <c

Error message

Couldn't find PropertyData for [<propertyName>] in class: <className>

What it means

Error "Couldn't find PropertyData for [<propertyName>] in class: <className>" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/boot/model/internal/EntityBinder.java:1257

	}

	private static MemberDetails getMemberDetails(
			InheritanceState inheritanceState,
			Map<ClassDetails, InheritanceState> inheritanceStates,
			Property declaredProperty,
			PersistentClass superclass) {
		var superclassDetails = inheritanceState.getClassDetails().getSuperClass();
		while ( !superclass.getClassName().equals( superclassDetails.getClassName()) ) {
			superclassDetails = superclassDetails.getSuperClass();
		}
		final var superclassInheritanceState = inheritanceStates.get( superclassDetails );
		final var elementsToProcess = superclassInheritanceState.getElementsToProcess();
		for ( var element : elementsToProcess.getElements() ) {
			if ( declaredProperty.getName().equals( element.getPropertyName() ) ) {
				return element.getAttributeMember();
			}
		}
		throw new IllegalArgumentException( "Couldn't find PropertyData for [" + declaredProperty.getName()
						+ "] in class: " + declaredProperty.getPersistentClass().getClassName() );
	}

	private static String getMissingPropertiesString(Set<String> propertyNames) {
		final var missingProperties = new StringBuilder();
		for ( String propertyName : propertyNames ) {
			if ( !missingProperties.isEmpty() ) {
				missingProperties.append( ", " );
			}
			missingProperties.append( "'" ).append( propertyName ).append( "'" );
		}
		return missingProperties.toString();
	}

	private static PersistentClass makePersistentClass(
			InheritanceState inheritanceState,
			PersistentClass superEntity,
			MetadataBuildingContext metadataBuildingContext) {

View on GitHub (pinned to fad1729dce)

Solutions

1. Verify the property name exists in the class and is accessible for persistence (field or getter).

When it happens

Trigger: Hibernate cannot locate the persistent property metadata referenced by the mapping.

Common situations: A mapped property name with no corresponding field/getter on the class, typically after renaming without updating the mapping.

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