解决 GORM + MySQL 5.7 报错:Error 1067: Invalid default value for ‘updated_at‘

当然可以!以下是一篇结构清晰、技术准确、适合发布在博客(如掘金、CSDN、个人博客等)的总结文章,标题和内容都已优化,便于读者理解和搜索:

🐞 解决 GORM + MySQL 5.7 报错:Error 1067: Invalid default value for 'updated_at'

关键词:GORM、MySQL 5.7、sql_mode、NO_ZERO_DATE、Error 1067、AutoMigrate、时间字段默认值

📌 问题现象

在使用 GORM(Go ORM) 自动建表(AutoMigrate)时,程序启动失败,报错如下:

Error 1067 (42000): Invalid default value for 'updated_at'

数据库环境:

MySQL 5.7.26(通过 phpStudy Pro 管理)

字符集:utf8

默认引擎原为 MyISAM,后改为 InnoDB

🔍 根本原因

MySQL 5.7 默认启用了严格的 sql_mode,其中包括:

text

NO_ZERO_DATE, NO_ZERO_IN_DATE, STRICT_TRANS_TABLES

这些模式会禁止使用 '0000-00-00' 或 '0000-00-00 00:00:00' 作为日期默认值。

而 GORM 在未显式指定时间字段类型时,可能生成类似这样的建表语句:

sql

updated_at datetime NOT NULL

由于字段为 NOT NULL 但没有合法默认值,MySQL 在严格模式下拒绝创建表,抛出 Error 1067。

💡 注意:即使你没手动写 DEFAULT '0000-00-00',GORM 的默认行为在某些配置下仍会触发零值逻辑。

✅ 解决方案(两种思路)

方案一:调整 MySQL 配置(适合本地开发)

  1. 修改 my.ini(phpStudy 路径示例):
    ini

    mysqld

    sql_mode=ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
    ✅ 移除了 NO_ZERO_DATE 和 NO_ZERO_IN_DATE,保留其他安全限制。
  2. 重启 MySQL 服务
  3. 验证生效:
    sql
    SELECT @@sql_mode;
    -- 确保输出中不含 NO_ZERO_DATE

✅ 优点:快速解决,无需改代码

⚠️ 缺点:降低数据校验强度,不建议用于生产环境

方案二:规范 GORM 模型定义(推荐长期使用)

在 Go 模型中显式指定时间字段类型和默认值:

go

import "time"

type BaseModel struct {

CreatedAt time.Time gorm:"type:timestamp;not null;default:CURRENT_TIMESTAMP"

UpdatedAt time.Time gorm:"type:timestamp;not null;default:CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP"

}

type Block struct {

ID uint gorm:"primarykey"

Hash string gorm:"uniqueIndex;size:333"

BaseModel

}

同时,在 AutoMigrate 时指定表引擎和行格式:

go

db.Set("gorm:table_options", "ENGINE=InnoDB ROW_FORMAT=DYNAMIC").

AutoMigrate(&Block{})

✅ 优点:

兼容严格模式

支持大索引(避免 Error 1071: Specified key was too long)

代码可移植性强

🧪 额外建议

  1. 确保使用 InnoDB 引擎

    在 my.ini 中设置:

    ini

    default-storage-engine=InnoDB

  2. 索引字段加长度限制(防 Error 1071):

    go

    Hash string gorm:"uniqueIndex;size:333" // utf8 下 333*3=999 < 1000

  3. 未来考虑迁移到 utf8mb4

    支持 emoji 和完整 Unicode,索引长度建议 size:191

✅ 总结

问题 原因 推荐解法


Error 1067: Invalid default value for 'updated_at' MySQL 严格模式禁止零日期,GORM 默认字段定义不合规 显式定义 type:timestamp + 合法默认值

Error 1071: Specified key was too long MyISAM 引擎索引限制 1000 字节 使用 InnoDB + ROW_FORMAT=DYNAMIC + 限制字段长度

最佳实践:保持 MySQL 严格模式开启,从代码层面保证数据合法性,而不是关闭安全限制。

📚 参考资料
MySQL 5.7 sql_mode 官方文档
GORM 模型字段定义
InnoDB 行格式与大索引支持

希望这篇总结对你有帮助!欢迎转发、收藏,也欢迎在评论区交流你的踩坑经历 😊

你可以直接复制这段内容发布到博客平台,如需 Markdown 或 HTML 版本,也可以告诉我!

相关推荐
九皇叔叔13 小时前
《MySQL 体系架构详解:Server 层、SQL 执行流程与 InnoDB、MyISAM、MEMORY 存储引擎》
sql·mysql·架构
愤怒的苹果ext16 小时前
MySQL Shell备份恢复数据库
数据库·mysql·备份恢复·mysqlsh
超兔一体云19 小时前
MySQL索引优化实战——从慢查询到索引调优
后端·mysql
2601_9620748119 小时前
大数据-264 实时数仓 - Canal MySQL的binlog研究 存储目录 变动信息 配置MySQL
大数据·数据库·mysql
2601_9620738120 小时前
大数据-240 离线数仓 - 广告业务 测试 ADS层数据加载 DataX数据导出到 MySQL
大数据·数据库·mysql
这个DBA有点耶1 天前
SQL:2023新特性详解:JSON_TABLE、GREATEST/LEAST、QUALIFY 到底怎么用?
数据库·sql·mysql
小王C语言1 天前
MySQL 用户管理:创建用户、给用户授权
数据库·mysql
小镇敲码人1 天前
【深入浅出】之Qt 事件系统实战:鼠标、键盘、滚轮、窗口与定时器事件
数据库·qt·网络协议·mysql·http
Sirens.1 天前
MySQL数据库:索引
数据库·mysql
2601_962072501 天前
大数据-234 离线数仓 - 异构数据源 DataX 将数据 从 HDFS 到 MySQL
大数据·mysql·hdfs