{"record":{"id":"6e0d1caa0e96f211","repo":"pinpoint-apm/pinpoint","slug":"syntax-error-expected-token-literal-token","errorCode":null,"errorMessage":"Syntax error. Expected token='LITERAL'' :<token>","messagePattern":"Syntax error\\. Expected token='LITERAL'' :<token>","errorType":"validation","errorClass":"OracleConnectionStringException","httpStatus":null,"severity":"error","filePath":"agent-module/plugins/oracle-jdbc/src/main/java/com/navercorp/pinpoint/plugin/jdbc/oracle/parser/OracleNetConnectionDescriptorTokenizer.java","lineNumber":220,"sourceCode":"    public void checkEndToken() {\n        Token token = this.nextToken();\n        if (token == null) {\n            throw new OracleConnectionStringException(\"parse error. token is null. Expected token=')\");\n        }\n        // We can check by == because the token object is singleton.\n        if (!(token == TOKEN_KEY_END_OBJECT)) {\n            throw new OracleConnectionStringException(\"Syntax error. Expected token=')' :\" + token.getToken());\n        }\n    }\n\n    public Token getLiteralToken() {\n        Token token = this.nextToken();\n        if (token == null) {\n            throw new OracleConnectionStringException(\"parse error. token is null. Expected token='LITERAL'\");\n        }\n        // We can check by == because the token object is singleton.\n        if (!(token.getType() == TYPE_LITERAL)) {\n            throw new OracleConnectionStringException(\"Syntax error. Expected token='LITERAL'' :\" + token.getToken());\n        }\n        return token;\n    }\n\n    public Token getLiteralToken(String expectedValue) {\n        Token token = this.nextToken();\n        if (token == null) {\n            throw new OracleConnectionStringException(\"parse error. token is null. Expected token='LITERAL'\");\n        }\n        // We can check by == because the token object is singleton.\n        if (!(token.getType() == TYPE_LITERAL)) {\n            throw new OracleConnectionStringException(\"Syntax error. Expected token='LITERAL' :\" + token.getToken());\n        }\n        if (!expectedValue.equals(token.getToken())) {\n            throw new OracleConnectionStringException(\"Syntax error. Expected token=\" + expectedValue + \"' :\" + token.getToken());\n        }\n        return token;\n    }","sourceCodeStart":202,"sourceCodeEnd":238,"githubUrl":"https://github.com/pinpoint-apm/pinpoint/blob/744c3d3075e595656abb1ae331ad2c0e4c9eb996/agent-module/plugins/oracle-jdbc/src/main/java/com/navercorp/pinpoint/plugin/jdbc/oracle/parser/OracleNetConnectionDescriptorTokenizer.java#L202-L238","documentation":"Parser guard in getLiteralToken: a token was available but its type is not TYPE_LITERAL — the parser expected a literal value for a descriptor key and instead found a syntax token like '(' or '='. Indicates misplaced punctuation in the Oracle connection descriptor.","triggerScenarios":"Thrown at agent-module/plugins/oracle-jdbc/src/main/java/com/navercorp/pinpoint/plugin/jdbc/oracle/parser/OracleNetConnectionDescriptorTokenizer.java:220 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Ensure values in the descriptor are literals, e.g. (HOST=myhost) not (HOST=(...))","Fix misplaced parentheses or '=' inside the value position"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"744c3d3075e595656abb1ae331ad2c0e4c9eb996","analyzedAt":"2026-09-07T18:48:45.289Z","contentChangedAt":"2026-09-07T18:48:45.289Z","schemaVersion":2},"datasetVersion":"2026-09-17T15:17:12.973Z"}