hibernate/hibernate-orm · error · MappingException

unknown FlushMode : {}

Error message

unknown FlushMode : {}

What it means

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

Source

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

		if ( externalName == null ) {
			return null;
		}

		try {
			JPA_LOGGER.attemptingToInterpretExternalSettingAsFlushModeName( externalName );
			return FlushMode.valueOf( externalName.toUpperCase( Locale.ROOT) );
		}
		catch ( IllegalArgumentException e ) {
			JPA_LOGGER.attemptingToInterpretExternalSettingAsFlushModeTypeName( externalName );
		}

		try {
			return getFlushMode( FlushModeType.valueOf( externalName.toLowerCase( Locale.ROOT ) ) );
		}
		catch ( IllegalArgumentException ignore ) {
		}

		throw new MappingException( "unknown FlushMode : " + externalName );
	}
}

View on GitHub (pinned to fad1729dce)

Solutions

1. Use one of the known FlushMode names (MANUAL, COMMIT, AUTO, ALWAYS); correct the configuration value.

When it happens

Trigger: Thrown at hibernate-core/src/main/java/org/hibernate/jpa/internal/util/FlushModeTypeHelper.java:222 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/51631ed1bc6b3693. Report an issue: GitHub.