hibernate/hibernate-orm · error · PersistenceException

Unknown TransactionType: '{}'

Error message

Unknown TransactionType: '{}'

What it means

Error "Unknown TransactionType: '{}'" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/jpa/internal/util/PersistenceUnitTransactionTypeHelper.java:47

		if ( value == null ) {
			return null;
		}
		else if ( value instanceof PersistenceUnitTransactionType transactionType ) {
			return transactionType;
		}
		else {
			final String stringValue = value.toString().trim();
			if ( stringValue.isEmpty() ) {
				return null;
			}
			else if ( JTA.name().equalsIgnoreCase( stringValue ) ) {
				return JTA;
			}
			else if ( RESOURCE_LOCAL.name().equalsIgnoreCase( stringValue ) ) {
				return RESOURCE_LOCAL;
			}
			else {
				throw new PersistenceException( "Unknown TransactionType: '" + stringValue + "'" );
			}
		}
	}
}

View on GitHub (pinned to fad1729dce)

Solutions

1. Use JTA or RESOURCE_LOCAL as the transaction-type in persistence.xml; correct typos or invalid values.

When it happens

Trigger: Thrown at hibernate-core/src/main/java/org/hibernate/jpa/internal/util/PersistenceUnitTransactionTypeHelper.java:47 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/770a9b7d6401ec30. Report an issue: GitHub.