hibernate/hibernate-orm · error · TransformationException

Error transforming <one-to-one/> : {}

Error message

Error transforming <one-to-one/> : {}

What it means

Error "Error transforming <one-to-one/> : {}" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/boot/jaxb/hbm/transform/HbmXmlTransformer.java:2183

				// }
				//
				// where the `name` could then be used for `@PropertyRef`
				handleUnsupported( "<properties/> mappings not supported for transformation [name=%s]", hbmProperties.getName() );
			}
			else if ( hbmAttributeMapping instanceof JaxbHbmDynamicComponentType dynamicComponentType) {
				final String name = dynamicComponentType.getName();
				handleUnsupported(
						"<dynamic-component/> mappings not supported for transformation [name=%s]",
						name
				);
			}
			else if ( hbmAttributeMapping instanceof JaxbHbmOneToOneType hbmOneToOne ) {
				try {
					final var propertyInfo = managedTypeInfo.propertyInfoMap().get( hbmOneToOne.getName() );
					transferOneToOne( hbmOneToOne, propertyInfo, attributes );
				}
				catch (Exception e) {
					throw new TransformationException( "Error transforming <one-to-one/> : " + hbmOneToOne.getName(), e, origin() );
				}
			}
			else if ( hbmAttributeMapping instanceof JaxbHbmManyToOneType hbmManyToOne ) {
				try {
					transferManyToOne( managedTypeInfo, attributes, hbmManyToOne );
				}
				catch (Exception e) {
					throw new TransformationException( "Error transforming <many-to-one/> : " + hbmManyToOne.getName(), e, origin() );
				}
			}
			else if ( hbmAttributeMapping instanceof JaxbHbmAnyAssociationType any ) {
				try {
					final var propertyInfo = managedTypeInfo.propertyInfoMap().get( any.getName() );
					attributes.getAnyMappingAttributes().add( transformAnyAttribute( any, propertyInfo ) );
				}
				catch (Exception e) {
					throw new TransformationException( "Error transforming <any/> : " + any.getName(), e, origin() );
				}

View on GitHub (pinned to fad1729dce)

Solutions

1. Check the <one-to-one/> element attributes (class, property-ref, constrained) for correctness.
2. Verify the referenced entity and property exist and are mapped.
3. Inspect the causal exception for the exact failure during transformation.

When it happens

Trigger: The hbm.xml to mapping.xml transformer hits an unexpected structure.

Common situations: Converting legacy hbm.xml documents containing constructs the transformer does not handle.

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