hibernate/hibernate-orm · error · HibernateException

Unrecognized value '{}' specified via 'hibernate.query.immut

Error message

Unrecognized value '{}' specified via 'hibernate.query.immutable_entity_update_query_handling_mode' (should be 'allow', 'warning', or 'exception')

What it means

Error "Unrecognized value '{}' specified via 'hibernate.query.immutable_entity_update_query_handling_mode' (should be 'allow', 'warning', or 'exception')" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/query/spi/ImmutableEntityUpdateQueryHandlingMode.java:67

	 *
	 * @param setting the configuration setting.
	 * @return the associated {@link ImmutableEntityUpdateQueryHandlingMode} object
	 */
	public static ImmutableEntityUpdateQueryHandlingMode interpret(Object setting) {
		if ( setting == null ) {
			return EXCEPTION;
		}
		else if ( setting instanceof ImmutableEntityUpdateQueryHandlingMode mode ) {
			return mode;
		}
		else if ( setting instanceof String string ) {
			for ( var value : values() ) {
				if ( value.name().equalsIgnoreCase( string ) ) {
					return value;
				}
			}
		}
		throw new HibernateException( "Unrecognized value '" + setting
				+ "' specified via '" + AvailableSettings.IMMUTABLE_ENTITY_UPDATE_QUERY_HANDLING_MODE
				+ "' (should be 'allow', 'warning', or 'exception')" );
	}
}

View on GitHub (pinned to fad1729dce)

Solutions

1. The hibernate.query.immutable_entity_update_query_handling_mode value is invalid. Set it to 'allow', 'warning', or 'exception'.

When it happens

Trigger: An unrecognized value is configured for the immutable-entity update handling mode: Unrecognized value '<value>' specified via 'hibernate.query.immutable_entity_update_query_handling_mode' (should be 'allow', 'warning', or 'exception')

Common situations: Setting hibernate.query.immutable_entity_update_query_handling_mode to something other than allow/warning/exception.

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