You need to enable JavaScript to run this app. 如何修复Django连接MySQL时触发的1064 SQL语法错误
优惠活动
大模型
产品
解决方案
定价
更多

如何修复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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 13:15:04