如何修复Django连接MySQL时触发的1064 SQL语法错误
Django MySQL连接触发1064语法错误的根因与修复
根因定位
报错的核心触发点完全来自OPTIONS中配置的init_command存在SQL语法错误,和当前使用的mysqlclient 1.4.6、MySQL 5.7.31版本、数据库通信协议没有兼容问题:
- MySQL 5.7及更早版本中,会话系统变量赋值的标准语法使用等号(
=)连接变量名与赋值内容,不支持用冒号(:)做赋值操作 - 你当前配置的
SET sql_mode:'STRICT_TRANS_TABLES'语句里,用冒号做sql_mode的赋值连接,MySQL服务端在语法校验时无法识别冒号的语义,直接将冒号后续的内容标记为语法错误段,才会抛出报错提示中near ':'STRICT_TRANS_TABLES''的异常。 - mysqlclient 1.4.6会将
init_command的内容原封不动下发给MySQL服务端执行,不会对SQL语法做自动修正,因此哪怕是极小的语法偏差都会直接触发服务端的语法校验报错。
适配当前环境的修复方案
不需要升级依赖、不需要调整MySQL服务端全局配置,仅需修正init_command的SQL语法,把赋值用的冒号替换为标准等号即可,修正后的完整配置参考:
DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'REDACTED', 'USER': 'REDACTED', 'PASSWORD': 'REDACTED', 'HOST': 'REDACTED', 'PORT': 'REDACTED', 'OPTIONS': { 'init_command': "SET sql_mode='STRICT_TRANS_TABLES'" } } }
注意事项
- 修正后的语句完全兼容当前使用的mysqlclient 1.4.6、MySQL 5.7.31环境,配置完成后重启Django服务即可正常建立连接
- 后续如果需要追加更多SQL_MODE规则,只需要在等号后的赋值字符串内用逗号分隔不同规则即可,例如
"SET sql_mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE'",同样符合MySQL 5.7的语法规范。
内容的提问来源于stack exchange,提问作者Esfar Immam
相关产品推荐
相关产品推荐

