MyBatis-Plus踩坑记：SQL关键字‘close‘引发的JSqlParser异常（附完整解决方案）

MyBatis-Plus开发实战：SQL关键字冲突与JSqlParser异常深度解析

上周排查一个生产环境问题时，发现控制台突然抛出net.sf.jsqlparser.parser.ParseException异常，而相同的SQL在Navicat中却能正常执行。经过深入排查，发现这是MyBatis-Plus 3.5.3.1版本与JSqlParser 4.4组合使用时的一个典型陷阱——SQL关键字处理存在兼容性问题。本文将分享完整的排查思路和三种解决方案。

1. 问题现象与初步分析

当我们的持仓盈亏查询接口抛出以下异常时，第一反应是SQL语法错误：

net.sf.jsqlparser.parser.ParseException: Encountered unexpected token: "," "," 
at line 8, column 38. Was expecting one of: ";" "CONNECT" "EMIT" "GROUP"...

但检查SQL语句却看似正常：

SELECT id, code, trade_date, close, name, num 
FROM stock_hold_profit

关键发现点：

• 异常发生在MyBatis-Plus的数据权限拦截器处理阶段
• 相同SQL直接执行无异常
• 报错位置指向字段列表中的逗号分隔符

通过DEBUG模式跟踪发现，问题核心在于JSqlParser 4.4版本对MySQL关键字的识别存在缺陷。上述SQL中的close字段实际上是MySQL保留字，但在低版本解析器中未被正确处理。

2. 根本原因深度剖析

2.1 JSqlParser版本兼容性矩阵

通过对比不同版本的解析行为，我们整理出关键版本差异：