hibernate/hibernate-orm · error · IllegalArgumentException

Unknown FlushMode source : {}

Error message

Unknown FlushMode source : {}

What it means

Error "Unknown FlushMode source : {}" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/jpa/internal/util/FlushModeTypeHelper.java:110

	public static FlushMode interpretFlushMode(Object value) {
		if ( value == null ) {
			return FlushMode.AUTO;
		}
		if ( value instanceof FlushMode flushMode ) {
			return flushMode;
		}
		if ( value instanceof QueryFlushMode queryFlushMode ) {
			return interpretFlushMode( queryFlushMode );
		}
		else if ( value instanceof FlushModeType flushModeType ) {
			return getFlushMode( flushModeType );
		}
		else if ( value instanceof String string ) {
			return interpretExternalSetting( string );
		}
		else {
			throw new IllegalArgumentException( "Unknown FlushMode source : " + value );
		}
	}

	public static QueryFlushMode queryFlushModeFromHint(Object value) {
		if ( value == null ) {
			return QueryFlushMode.DEFAULT;
		}
		else if ( value instanceof QueryFlushMode qfm ) {
			return qfm;
		}
		else if ( value instanceof FlushMode fm ) {
			return queryFlushModeFromFlushMode( fm );
		}
		else if ( value instanceof FlushModeType fmt ) {
			return queryFlushModeFromFlushModeType( fmt );
		}
		else {
			return interpretQueryFlushMode( value.toString() );

View on GitHub (pinned to fad1729dce)

Solutions

1. Use a recognized FlushMode source (jakarta.persistence.FlushModeType or org.hibernate.FlushMode); fix the value passed to the conversion.

When it happens

Trigger: Thrown at hibernate-core/src/main/java/org/hibernate/jpa/internal/util/FlushModeTypeHelper.java:110 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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