hibernate/hibernate-orm · error · IllegalStateException

Could not resolve table reference `%s` relative to TableGrou

Error message

Could not resolve table reference `%s` relative to TableGroup `%s` related with NavigablePath `%s`

What it means

Error "Could not resolve table reference `%s` relative to TableGroup `%s` related with NavigablePath `%s`" thrown in hibernate/hibernate-orm.

Source

Thrown at hibernate-core/src/main/java/org/hibernate/metamodel/mapping/internal/BasicEntityIdentifierMappingImpl.java:266

			TableGroup tableGroup,
			FetchParent fetchParent,
			DomainResultCreationState creationState) {
		final var expressionResolver = creationState.getSqlAstCreationState().getSqlExpressionResolver();
		final var rootTableReference = rootTableReference( navigablePath, tableGroup );
		return expressionResolver.resolveSqlSelection(
				expressionResolver.resolveSqlExpression( rootTableReference, this ),
				idType.getJdbcJavaType(),
				fetchParent,
				sessionFactory.getTypeConfiguration()
		);
	}

	private TableReference rootTableReference(NavigablePath navigablePath, TableGroup tableGroup) {
		try {
			return tableGroup.resolveTableReference( navigablePath, rootTable );
		}
		catch (Exception e) {
			throw new IllegalStateException(
					String.format(
							Locale.ROOT,
							"Could not resolve table reference `%s` relative to TableGroup `%s` related with NavigablePath `%s`",
							rootTable,
							tableGroup,
							navigablePath
					),
					e
			);
		}
	}

	@Override
	public String getContainingTableExpression() {
		return rootTable;
	}

	@Override

View on GitHub (pinned to fad1729dce)

Solutions

1. Verify the table reference name used in the mapping/query matches the entity's table name or a known alias within the current table group.

When it happens

Trigger: Thrown when resolving a table reference for an entity identifier relative to a table group fails because the named table is not part of that group.

Common situations: See trigger scenarios.

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