pinpoint-apm/pinpoint · error · OracleConnectionStringException
Syntax error. Expected token=
Error message
Syntax error. Expected token=<expectedValue>' :<token>
What it means
Parser guard in getLiteralToken(expectedValue): the token stream was exhausted (null token) while the parser required a specific literal keyword next. Fires when the Oracle connection descriptor is truncated right before a mandatory keyword.
Solutions
- Complete the descriptor — add the missing mandatory keyword
- Verify the JDBC URL was not truncated by config templating or escaping
Defensive patterns
Strategy: validation
When it happens
Trigger: Thrown at agent-module/plugins/oracle-jdbc/src/main/java/com/navercorp/pinpoint/plugin/jdbc/oracle/parser/OracleNetConnectionDescriptorTokenizer.java:235 when the library encounters an invalid state.
Common situations: See trigger scenarios.
AI-assisted analysis of pinpoint-apm/pinpoint@744c3d3075 (2026-09-07).
Data as JSON: /api/errors/40dfaffa97452163.
Report an issue: GitHub.
Appendix: source
Thrown at agent-module/plugins/oracle-jdbc/src/main/java/com/navercorp/pinpoint/plugin/jdbc/oracle/parser/OracleNetConnectionDescriptorTokenizer.java:235
}
// We can check by == because the token object is singleton.
if (!(token.getType() == TYPE_LITERAL)) {
throw new OracleConnectionStringException("Syntax error. Expected token='LITERAL'' :" + token.getToken());
}
return token;
}
public Token getLiteralToken(String expectedValue) {
Token token = this.nextToken();
if (token == null) {
throw new OracleConnectionStringException("parse error. token is null. Expected token='LITERAL'");
}
// We can check by == because the token object is singleton.
if (!(token.getType() == TYPE_LITERAL)) {
throw new OracleConnectionStringException("Syntax error. Expected token='LITERAL' :" + token.getToken());
}
if (!expectedValue.equals(token.getToken())) {
throw new OracleConnectionStringException("Syntax error. Expected token=" + expectedValue + "' :" + token.getToken());
}
return token;
}
}
View on GitHub (pinned to 744c3d3075)