hibernate/hibernate-orm · error · MappingException

{} member '{}' is not mapped as a property on @Changelog '{}

Error message

{} member '{}' is not mapped as a property on @Changelog '{}'

What it means

Error "{} member '{}' is not mapped as a property on @Changelog '{}'" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/boot/model/internal/AuditHelper.java:566

					column.setUnique( true );
				}
			}
		}
	}

	/**
	 * Validate that a named property exists and is mapped as a {@link BasicValue}.
	 */
	private static Property requireBasicProperty(
			PersistentClass entityBinding,
			String propertyName,
			String annotationName) {
		final Property property;
		try {
			property = entityBinding.getProperty( propertyName );
		}
		catch (MappingException e) {
			throw new MappingException(
					annotationName + " member '" + propertyName
							+ "' is not mapped as a property on @Changelog '"
							+ entityBinding.getEntityName() + "'"
			);
		}
		if ( !( property.getValue() instanceof BasicValue ) ) {
			throw new MappingException(
					annotationName + " property '" + entityBinding.getEntityName()
							+ "." + propertyName + "' must be a basic attribute"
			);
		}
		return property;
	}

	/**
	 * Create an audit table for the given source table: copy columns,
	 * add the REV column, create the composite PK, and add the
	 * REV -> REVINFO FK (if a changelog entity is configured).

View on GitHub (pinned to fad1729dce)

Solutions

1. Map the referenced member as a persistent property (e.g. add @Basic/@Column or the appropriate mapping annotation) on the @Changelog class.
2. Or remove the reference to the unmapped member from the changelog configuration.

When it happens

Trigger: An Envers-style @Changelog member mapping is invalid (multiple annotated members, unmapped member, or non-basic attribute).

Common situations: Audited entities where the changelog class has more than one tracked member, references a property that is not mapped, or tracks a non-basic (association/embeddable) attribute.

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