一、遇到的错误
在日常开发中，尤其是使用 MyBatis 等 ORM 框架操作 SQL 时，我们经常会遇到类似下面的错误。
### Error querying database. Cause: java.sql.SQLSyntaxErrorException:
You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version
for the right syntax to use near 'FROM wk_crm_check AS a ...' at line 5
这个错误看起来提示的是 FROM 子句有语法问题，但真正的原因并不是 FROM 本身写错了，而是我们在 SELECT 字段列表的最后一项后面 多写了一个逗号（,），导致 MySQL 无法正确解析后续的语句。
我们看到，在 SELECT 的字段列表中，最后一行 后面误加了一个逗号。这会导致 SQL 引擎在解析 , FROM 时发生语法错误。
二、报错信息解析
You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version
for the right syntax to use near 'FROM wk_crm_check AS a ...' at line 5
这句提示中关键点是：
-
near 'FROM ...'表示错误发生在FROM附近 -
实际上是前一行结尾写了多余的逗号，导致
, FROM出错
MySQL 在语法错误时，并不会告诉你“多了个逗号”，而是告诉你“从这个位置起解析失败了”，所以我们需要根据上下文自行判断。
三、正确写法
掉多余逗号即可：
SELECT
a.*,
c.num AS contract_num,
c.money AS contract_money,
d.realname AS owner_user_name,
e.realname AS create_user_name
FROM wk_crm_check AS a
LEFT JOIN wk_crm_customer AS b ON a.customer_id = b.customer_id
LEFT JOIN wk_crm_contract AS c ON a.contract_id = c.contract_id
LEFT JOIN wk_admin_user AS d ON a.owner_user_id = d.user_id
LEFT JOIN wk_admin_user AS e ON a.create_user_id = e.user_id
WHERE a.check_id = #{id};
四、建议与总结
1. 避免手写 SQL 时留尾逗号
写 SQL 时建议不要让 SELECT 语句中最后一行字段后面加逗号，可以使用编辑器插件自动去除末尾逗号，或者在 SQL 模板中进行约束。
2. 使用格式化工具
使用 SQL 格式化工具（如 SQL Formatter）可以更容易地发现语法错误，特别是在字段很多时。
3. MyBatis XML 中尤其注意
MyBatis 的 XML SQL 语句拼接时，往往使用 <if>、<choose> 等标签拼接字段，最容易留下 尾逗号，务必加上 <trim suffixOverrides=","> 这样的防错策略。
4. 错误提示要学会“翻译”
MySQL 错误信息通常不会直白告诉你“哪个字符错了”，而是告诉你“在哪个词附近解析失败”，我们要学会根据提示自行判断错误根因。
