解决JSqlParser解析异常：unexpected token ‘.’ 的实战指南

1次阅读

共计 2210 个字符，预计需要花费 6 分钟才能阅读完成。

JSqlParser 是一个流行的 Java SQL 解析器，它可以将 SQL 语句解析为抽象语法树（AST），方便开发者对 SQL 进行动态修改、分析或校验。它在数据库迁移、SQL 审计、ORM 框架等场景中广泛应用。

然而，在实际使用中，开发者经常会遇到 caused by: net.sf.jsqlparser.parser.parseexception: encountered unexpected token: "." 这样的解析错误。这种错误通常发生在 SQL 语句不符合 JSqlParser 的语法规范时，比如使用了不规范的语法或包含特殊字符。

unexpected token 错误通常由以下几种情况触发：

SQL 语法不规范 ：JSqlParser 对 SQL 语法的要求较为严格，尤其是标点符号的使用。例如，多余的 . 或缺少必要的分隔符（如 ;）都可能导致解析失败。
特殊字符处理不当 ：SQL 语句中如果包含未转义的特殊字符（如引号、反斜杠等），解析器可能会误判语法结构。
SQL 片段不完整 ：如果尝试解析的 SQL 是片段（比如动态拼接的语句），缺少关键字或子句，解析器也可能报错。

确保 SQL 语句符合标准语法规则，尤其是标点符号和关键字的使用。例如，以下 SQL 会因为多余的 . 导致解析失败：

SELECT * FROM users WHERE name = 'John.Doe'.

修正为：

SELECT * FROM users WHERE name = 'John.Doe';

如果 SQL 中包含特殊字符（如 .、'、" 等），需要进行转义或使用参数化查询。例如：

String sql = "SELECT * FROM users WHERE name = ?";
PreparedStatement stmt = connection.prepareStatement(sql);
stmt.setString(1, "John.Doe");

JSqlParser 提供了一些配置选项，可以灵活调整解析行为。例如，通过 CCJSqlParserUtil.parse() 方法可以设置解析器的容错模式：

CCJSqlParserUtil.parse(sql, parser -> {parser.withSquareBracketQuotation(true); // 允许方括号引用标识符
    parser.withAllowComplexParsing(true); // 允许复杂解析
});

以下是一个完整的 Java 示例，展示如何捕获和处理 unexpected token 异常：

import net.sf.jsqlparser.JSQLParserException;
import net.sf.jsqlparser.parser.CCJSqlParserUtil;
import net.sf.jsqlparser.statement.Statement;

public class JSqlParserDemo {public static void main(String[] args) {
        String sql = "SELECT * FROM users WHERE name ='John.Doe'."; // 错误的 SQL

        try {Statement statement = CCJSqlParserUtil.parse(sql);
            System.out.println("SQL 解析成功:" + statement);
        } catch (JSQLParserException e) {System.err.println("SQL 解析失败:" + e.getMessage());
            // 建议日志记录或告警
            e.printStackTrace();

            // 尝试修复 SQL（例如去除多余的 '.'）String fixedSql = sql.replaceAll("\\.$", "");
            System.out.println("尝试修复后的 SQL:" + fixedSql);

            try {Statement fixedStatement = CCJSqlParserUtil.parse(fixedSql);
                System.out.println("修复后解析成功:" + fixedStatement);
            } catch (JSQLParserException ex) {System.err.println("修复后仍然失败:" + ex.getMessage());
            }
        }
    }
}