{"record":{"id":"7c772f829663b25b","repo":"hibernate/hibernate-orm","slug":"not-a-byte-hextext","errorCode":null,"errorMessage":"not a byte: {hexText}","messagePattern":"not a byte: (.+?)","errorType":"exception","errorClass":"LiteralNumberFormatException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/query/hql/internal/SemanticQueryBuilder.java","lineNumber":4051,"sourceCode":"\t\t\tdefault -> throw new ParsingException( \"Unexpected terminal node [\" + text + \"]\" );\n\t\t};\n\t}\n\n\t@Override\n\tpublic Object visitBinaryLiteral(HqlParser.BinaryLiteralContext ctx) {\n\t\tfinal var firstNode = (TerminalNode) ctx.getChild( 0 );\n\t\tif ( firstNode.getSymbol().getType() == HqlParser.BINARY_LITERAL ) {\n\t\t\treturn binaryLiteral( firstNode.getText() );\n\t\t}\n\t\telse {\n\t\t\tfinal var text = new StringBuilder( \"x'\" );\n\t\t\tfinal int size = ctx.getChildCount();\n\t\t\tfor ( int i = 0; i < size; i++ ) {\n\t\t\t\tfinal var hex = (TerminalNode) ctx.getChild( i );\n\t\t\t\tif ( hex.getSymbol().getType() == HqlParser.HEX_LITERAL ) {\n\t\t\t\t\tfinal String hexText = hex.getText();\n\t\t\t\t\tif ( hexText.length() != 4 ) {\n\t\t\t\t\t\tthrow new LiteralNumberFormatException( \"not a byte: \" + hexText );\n\t\t\t\t\t}\n\t\t\t\t\ttext.append( hexText, 2, hexText.length() );\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn binaryLiteral( text.append( \"'\" ).toString() );\n\t\t}\n\t}\n\n\t@Override\n\tpublic Object visitArrayLiteral(HqlParser.ArrayLiteralContext ctx) {\n\t\tfinal var expressionContexts = ctx.expression();\n\t\tfinal int count = expressionContexts.size();\n\t\tfinal List<SqmTypedNode<?>> arguments = new ArrayList<>( count );\n\t\tfor ( var expressionContext : expressionContexts ) {\n\t\t\targuments.add( (SqmTypedNode<?>) expressionContext.accept( this ) );\n\t\t}\n\t\treturn getFunctionDescriptor( \"array\" ).generateSqmExpression(\n\t\t\t\targuments,","sourceCodeStart":4033,"sourceCodeEnd":4069,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/query/hql/internal/SemanticQueryBuilder.java#L4033-L4069","documentation":"Error \"not a byte: {hexText}\" thrown in hibernate/hibernate-orm.","triggerScenarios":"A hexadecimal literal contains a value outside the byte range: not a byte: <value>","commonSituations":"HQL binary/hex literals containing byte values that cannot be parsed.","solutions":["The binary/hex literal is not a valid byte value. Ensure the hexadecimal text in the literal contains an even number of valid hex digits representing byte values."],"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"}