{"record":{"id":"6ae694a725dbe87e","repo":"hibernate/hibernate-orm","slug":"unable-to-locate-tablereference-for-s-s","errorCode":null,"errorMessage":"Unable to locate TableReference for '%s' : %s","messagePattern":"Unable to locate TableReference for '(.+?)' : (.+?)","errorType":"exception","errorClass":"IllegalStateException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/loader/ast/internal/AbstractNaturalIdLoader.java","lineNumber":184,"sourceCode":"\t\t\tTableGroup rootTableGroup,\n\t\t\tConsumer<Predicate> predicateConsumer,\n\t\t\tBiConsumer<JdbcParameter, JdbcParameterBinding> jdbcParameterConsumer,\n\t\t\tLoaderSqlAstCreationState sqlAstCreationState,\n\t\t\tSharedSessionContractImplementor session);\n\n\t/**\n\t * Helper to resolve ColumnReferences\n\t */\n\tprotected Expression resolveColumnReference(\n\t\t\tTableGroup rootTableGroup,\n\t\t\tSelectableMapping selectableMapping,\n\t\t\tSqlExpressionResolver sqlExpressionResolver) {\n\t\tfinal var tableReference = rootTableGroup.getTableReference(\n\t\t\t\trootTableGroup.getNavigablePath(),\n\t\t\t\tselectableMapping.getContainingTableExpression()\n\t\t);\n\t\tif ( tableReference == null ) {\n\t\t\tthrow new IllegalStateException(\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 locate TableReference for '%s' : %s\",\n\t\t\t\t\t\t\tselectableMapping.getContainingTableExpression(),\n\t\t\t\t\t\t\trootTableGroup\n\t\t\t\t\t)\n\t\t\t);\n\t\t}\n\t\treturn sqlExpressionResolver.resolveSqlExpression( tableReference, selectableMapping );\n\t}\n\n\t@Override\n\tpublic Object resolveNaturalIdToId(Object naturalIdValue, SharedSessionContractImplementor session) {\n\t\tif ( NATURAL_ID_LOGGER.isTraceEnabled() ) {\n\t\t\tNATURAL_ID_LOGGER.retrievingIdForNaturalId(\n\t\t\t\t\tentityDescriptor.getEntityName(),\n\t\t\t\t\tnaturalIdValue instanceof Object[] array\n\t\t\t\t\t\t\t? Arrays.toString( array )","sourceCodeStart":166,"sourceCodeEnd":202,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/loader/ast/internal/AbstractNaturalIdLoader.java#L166-L202","documentation":"Error \"Unable to locate TableReference for '%s' : %s\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Thrown at hibernate-core/src/main/java/org/hibernate/loader/ast/internal/AbstractNaturalIdLoader.java:184 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify the natural-id attribute name and mapping; ensure the referenced column/property exists in the entity mapping."],"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"}