{"record":{"id":"431e58e8cfc1e990","repo":"hibernate/hibernate-orm","slug":"invalid-path-qualifier-expecting-key-or","errorCode":null,"errorMessage":"Invalid path qualifier [{}] - expecting 'key' or 'value'","messagePattern":"Invalid path qualifier \\[(.+?)\\] - expecting 'key' or 'value'","errorType":"exception","errorClass":"InvalidGraphException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/graph/internal/parse/GraphParser.java","lineNumber":163,"sourceCode":"\t\tfinal var currentGraph = graphStack.getCurrent();\n\t\tassert currentGraph != null;\n\n\t\tfinal var attributeNode = currentGraph.findOrCreateAttributeNode( attributeName );\n\t\tassert attributeNode != null;\n\n\t\treturn attributeNode;\n\t}\n\n\tprivate PathQualifierType resolvePathQualifier(String qualifier) {\n\t\tif ( \"key\".equalsIgnoreCase( qualifier ) ) {\n\t\t\treturn PathQualifierType.KEY;\n\t\t}\n\n\t\tif ( \"value\".equalsIgnoreCase( qualifier ) ) {\n\t\t\treturn PathQualifierType.VALUE;\n\t\t}\n\n\t\tthrow new InvalidGraphException( \"Invalid path qualifier [\" + qualifier + \"] - expecting 'key' or 'value'\" );\n\t}\n\n\t@Override\n\tpublic SubGraphImplementor<?> visitSubGraph(GraphLanguageParser.SubGraphContext subGraphContext) {\n\t\tfinal String subTypeName =\n\t\t\t\tsubGraphContext.subTypeIndicator() == null ? null\n\t\t\t\t\t\t: subGraphContext.subTypeIndicator().TYPE_NAME().getText();\n\n\t\tif ( PARSING_LOGGER.isTraceEnabled() ) {\n\t\t\tPARSING_LOGGER.tracef(\n\t\t\t\t\t\"%s Starting graph: %s\",\n\t\t\t\t\trepeat( \">>\", attributeNodeStack.depth() + 2 ),\n\t\t\t\t\tsubTypeName\n\t\t\t);\n\t\t}\n\n\t\tfinal var attributeNode = attributeNodeStack.getCurrent();\n","sourceCodeStart":145,"sourceCodeEnd":181,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/graph/internal/parse/GraphParser.java#L145-L181","documentation":"Error \"Invalid path qualifier [{}] - expecting 'key' or 'value'\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Thrown while parsing an entity graph string whose map attribute path uses a qualifier other than 'key' or 'value'.","commonSituations":"Typical situations: typos in graph text; legacy vs modern graph syntax mixed up.","solutions":["Use only 'key' or 'value' as path qualifiers for map-valued attributes in entity graph text."],"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"}