{"record":{"id":"be6d815c10ce4798","repo":"hibernate/hibernate-orm","slug":"unable-to-determine-tablereference-s-for-s-be6d81","errorCode":null,"errorMessage":"Unable to determine TableReference (`%s`) for `%s`","messagePattern":"Unable to determine TableReference \\(`(.+?)`\\) for `(.+?)`","errorType":"exception","errorClass":"UnknownTableReferenceException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/sql/ast/tree/from/UnionTableReference.java","lineNumber":45,"sourceCode":"\tpublic UnionTableReference(\n\t\t\tString unionTableExpression,\n\t\t\tString[] subclassTableSpaceExpressions,\n\t\t\tString identificationVariable,\n\t\t\tboolean isOptional) {\n\t\tsuper( unionTableExpression, identificationVariable, isOptional );\n\n\t\tthis.subclassTableSpaceExpressions = subclassTableSpaceExpressions;\n\t}\n\n\t@Override\n\tpublic TableReference resolveTableReference(\n\t\t\tNavigablePath navigablePath,\n\t\t\tString tableExpression) {\n\t\tif ( hasTableExpression( tableExpression ) ) {\n\t\t\treturn this;\n\t\t}\n\n\t\tthrow new UnknownTableReferenceException(\n\t\t\t\ttableExpression,\n\t\t\t\tString.format(\n\t\t\t\t\t\tLocale.ROOT,\n\t\t\t\t\t\t\"Unable to determine TableReference (`%s`) for `%s`\",\n\t\t\t\t\t\ttableExpression,\n\t\t\t\t\t\tnavigablePath\n\t\t\t\t)\n\t\t);\n\t}\n\n\t@Override\n\tpublic TableReference getTableReference(\n\t\t\tNavigablePath navigablePath,\n\t\t\tString tableExpression,\n\t\t\tboolean resolve) {\n\t\tif ( hasTableExpression( tableExpression ) ) {\n\t\t\treturn this;\n\t\t}","sourceCodeStart":27,"sourceCodeEnd":63,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/sql/ast/tree/from/UnionTableReference.java#L27-L63","documentation":"Error \"Unable to determine TableReference (`%s`) for `%s`\" thrown in hibernate/hibernate-orm.","triggerScenarios":"A column reference qualifier cannot be resolved against a union table reference.","commonSituations":"Querying a UNION subclass table-per-class mapping and qualifying a column with an alias not resolvable on the union table.","solutions":["The column reference qualifier does not match the union table reference. Verify qualification of columns selected from the union/entity using union subclass mappings.","If generated internally by Hibernate, report it as a Hibernate bug with the query and stack trace."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fad1729dce015f908198d57a8d80274a30f905a5","analyzedAt":"2026-08-22T04:13:57.527Z","schemaVersion":2},"datasetVersion":"2026-08-22T09:17:25.309Z"}