hibernate/hibernate-orm · error · UnsupportedOperationException

The '${storageEngine}' storage engine is not supported

Error message

The '${storageEngine}' storage engine is not supported

What it means

Error "The '${storageEngine}' storage engine is not supported" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/dialect/MySQLDialect.java:269

					// Ignore
				}
			}
		}
		return info.makeCopyOrDefault( defaultVersion );
	}

	@Override
	protected DatabaseVersion getMinimumSupportedVersion() {
		return MINIMUM_VERSION;
	}

	private MySQLStorageEngine createStorageEngine(String configuredStorageEngine) {
		return configuredStorageEngine == null
				? getDefaultMySQLStorageEngine()
				: switch ( configuredStorageEngine.toLowerCase(Locale.ROOT) ) {
					case "innodb" -> InnoDBStorageEngine.INSTANCE;
					case "myisam" -> MyISAMStorageEngine.INSTANCE;
					default -> throw new UnsupportedOperationException(
							"The '" + storageEngine + "' storage engine is not supported" );
				};
	}

	@Override
	protected String columnType(int sqlTypeCode) {
		return switch (sqlTypeCode) {
			// HHH-6935: Don't use "boolean" i.e. tinyint(1) due to JDBC ResultSetMetaData
			case BOOLEAN -> "bit";

			case TIMESTAMP -> "datetime($p)";
			case TIMESTAMP_WITH_TIMEZONE -> "timestamp($p)";

			case NUMERIC -> columnType( DECIMAL ); // it's just a synonym

			// MySQL strips space characters from any value stored in a char column, which
			// is especially pathological in the case of storing characters in char(1)
			case CHAR -> "varchar($l)";

View on GitHub (pinned to fad1729dce)

Solutions

1. Configure the dialect with InnoDB or MyISAM storage engine.
2. Check the hibernate.dialect.storage_engine setting.

When it happens

Trigger: Triggered when the application calls a Hibernate dialect feature that the configured database dialect cannot provide: The 'the given storage engine' storage engine is not supported.

Common situations: Common when running against a database whose dialect lacks this capability, when a mapping or HQL/Criteria query requests unsupported functionality, or when the wrong dialect is configured for the database in use. Error: The 'the given storage engine' storage engine is not supported.

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