同一SQL查询在Windows运行正常但Ubuntu MySQL环境触发语法错误如何解决

根因定位 #

你遇到的语法报错核心原因是MySQL版本差异导致的内置函数兼容性问题：PASSWORD()是MySQL 5.7及更早版本的内置加密函数，MySQL 8.0及以上版本已经正式移除该函数，所以低版本Windows测试环境能正常执行的语句，在高版本Ubuntu正式环境会触发语法错误。 #

排查步骤 #

1. 分别在两台SQL服务器的MySQL终端执行版本查询命令：

SELECT VERSION();

如果Ubuntu环境返回的版本号≥8.0，即可确认是函数移除导致的问题。
2. 若版本一致仍报错，对比两边的SQL_MODE配置：

SELECT @@sql_mode;

检查Ubuntu环境是否开启了更严格的语法校验规则，特殊字符转义逻辑和测试环境不一致。 #

修复方案 #

临时验证方案 #

如果只是临时需要查询匹配密码的用户，可替换为8.0兼容的加密函数：

-- 对应旧版PASSWORD()的等效加密逻辑（mysql_native_password算法）
SELECT * FROM utilisateur WHERE mail="bla.bla@bla.fr" AND MdP=CONCAT('*', UPPER(SHA1(UNHEX(SHA1("Pass&word45")))));

长期兼容方案 #

1. 若要保留旧的密码哈希数据，可修改Ubuntu环境的MySQL配置文件my.cnf，添加以下配置后重启MySQL服务，临时兼容旧语法：

default-authentication-plugin=mysql_native_password

2. 推荐的永久修复方案：全量更新用户密码数据，使用官方推荐的SHA2("明文密码", 256)或caching_sha2_password算法重新加密存储，同步替换业务代码中所有PASSWORD()函数的调用，彻底适配高版本MySQL，避免后续安全风险。

内容的提问来源于stack exchange，提问作者Monsieur_Placard