hibernate/hibernate-orm · error · MappingException

Unsupported cascade style: ${cascade}

Error message

Unsupported cascade style: ${cascade}

What it means

Error "Unsupported cascade style: ${cascade}" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/engine/spi/CascadeStyles.java:236

		base.put( "delete", DELETE );
		base.put( "remove", DELETE ); // adds remove as a sort-of alias for delete...
		base.put( "delete-orphan", DELETE_ORPHAN );
		base.put( "none", NONE );

		return base;
	}

	/**
	 * Factory method for obtaining named cascade styles
	 *
	 * @param cascade The named cascade style name.
	 *
	 * @return The appropriate CascadeStyle
	 */
	public static CascadeStyle getCascadeStyle(String cascade) {
		CascadeStyle style = STYLES.get( cascade );
		if ( style == null ) {
			throw new MappingException( "Unsupported cascade style: " + cascade );
		}
		else {
			return style;
		}
	}

	public static void registerCascadeStyle(String name, BaseCascadeStyle cascadeStyle) {
		LOG.tracef( "Registering external cascade style [%s : %s]", name, cascadeStyle );
		final CascadeStyle old = STYLES.put( name, cascadeStyle );
		if ( old != null ) {
			LOG.debugf(
					"External cascade style registration [%s : %s] overrode base registration [%s]",
					name,
					cascadeStyle,
					old
			);
		}
	}

View on GitHub (pinned to fad1729dce)

Solutions

1. Use a supported cascade style (e.g. PERSIST, MERGE, REMOVE, REFRESH, DETACH, ALL)
2. Remove or correct the unsupported cascade setting on the association

When it happens

Trigger: Thrown at hibernate-core/src/main/java/org/hibernate/engine/spi/CascadeStyles.java:236 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/ff56df66447ff693. Report an issue: GitHub.