hibernate/hibernate-orm · error · ConfigurationException

Unable to apply settings from properties file [%s]

Error message

Unable to apply settings from properties file [%s]

What it means

Error "Unable to apply settings from properties file [%s]" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/boot/cfgxml/internal/ConfigLoader.java:115

			}
			finally {
				try {
					stream.close();
				}
				catch (IOException e) {
					BOOT_LOGGER.unableToCloseCfgXmlUrlStream( e );
				}
			}
		}
		catch (IOException e) {
			throw new ConfigurationException( "Could not access given cfg.xml URL input stream", e );
		}
	}

	public Properties loadProperties(String resourceName) {
		final var stream = locateStream( resourceName );
		if ( stream == null ) {
			throw new ConfigurationException( "Unable to apply settings from properties file [" + resourceName + "]" );
		}

		try {
			return loadProperties( stream );
		}
		catch (IOException e) {
			throw new ConfigurationException( "Unable to apply settings from properties file [" + resourceName + "]", e );
		}
		finally {
			try {
				stream.close();
			}
			catch (IOException e) {
				BOOT_LOGGER.unableToClosePropertiesFileStream( resourceName, e );
			}
		}
	}

View on GitHub (pinned to fad1729dce)

Solutions

1. Confirm the properties file path/URL exists and is readable by the application.
2. Validate the properties file syntax (key=value pairs, no malformed unicode escapes).
3. Check file encoding; use ISO-8859-1 or properly escaped unicode as required by java.util.Properties.

When it happens

Trigger: A configuration resource (cfg.xml URL or properties file) cannot be opened or read.

Common situations: Unreadable or missing config files, wrong URLs, or IO errors while Hibernate loads settings during bootstrap.

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