{"record":{"id":"e1669109b8574ed5","repo":"hibernate/hibernate-orm","slug":"unable-to-determine-tablereference-s-for-s","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/metamodel/mapping/internal/SimpleForeignKeyDescriptor.java","lineNumber":365,"sourceCode":"\n\tprivate <T> DomainResult<T> createDomainResult(\n\t\t\tNavigablePath navigablePath,\n\t\t\tTableGroup tableGroup,\n\t\t\tBasicValuedModelPart selectableMapping,\n\t\t\tFetchParent fetchParent,\n\t\t\tDomainResultCreationState creationState) {\n\t\tfinal var sqlAstCreationState = creationState.getSqlAstCreationState();\n\t\tfinal var sqlExpressionResolver = sqlAstCreationState.getSqlExpressionResolver();\n\t\tfinal TableReference tableReference;\n\t\ttry {\n\t\t\ttableReference = tableGroup.resolveTableReference(\n\t\t\t\t\tnavigablePath,\n\t\t\t\t\tselectableMapping,\n\t\t\t\t\tselectableMapping.getContainingTableExpression()\n\t\t\t);\n\t\t}\n\t\tcatch (IllegalStateException tableNotFoundException) {\n\t\t\tthrow new UnknownTableReferenceException(\n\t\t\t\t\tselectableMapping.getContainingTableExpression(),\n\t\t\t\t\tString.format(\n\t\t\t\t\t\t\tLocale.ROOT,\n\t\t\t\t\t\t\t\"Unable to determine TableReference (`%s`) for `%s`\",\n\t\t\t\t\t\t\tselectableMapping.getContainingTableExpression(),\n\t\t\t\t\t\t\tgetNavigableRole().getFullPath()\n\t\t\t\t\t)\n\t\t\t);\n\t\t}\n\n\t\tfinal var javaType = selectableMapping.getJdbcMapping().getJdbcJavaType();\n\t\tfinal var sqlSelection = sqlExpressionResolver.resolveSqlSelection(\n\t\t\t\tsqlExpressionResolver.resolveSqlExpression( tableReference, selectableMapping ),\n\t\t\t\tjavaType,\n\t\t\t\tfetchParent,\n\t\t\t\tsqlAstCreationState.getCreationContext().getTypeConfiguration()\n\t\t);\n","sourceCodeStart":347,"sourceCodeEnd":383,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/internal/SimpleForeignKeyDescriptor.java#L347-L383","documentation":"Error \"Unable to determine TableReference (`%s`) for `%s`\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Thrown when a simple foreign key descriptor cannot determine the referenced table for its key column during SQL rendering.","commonSituations":"See trigger scenarios.","solutions":["Verify the join column/table names in the association mapping refer to tables that are part of the current query's table group."],"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"}