解决 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 版本,也可以告诉我!

相关推荐
for_ever_love__33 分钟前
MySQL 索引类型全解:B+Tree / Hash / R-Tree / 全文 的底层差异,以及一次性建对的选型表
数据库·mysql·b+树·唯一索引·全文索引·索引类型·索引分类
天天喝旺仔10 小时前
MySQL 索引原理与慢查询优化实战:从 B+ 树到执行计划调优
数据库·sql·mysql·性能优化
m0_6464299711 小时前
MySQL 初始化 SQL 中文乱码问题总结
数据库·sql·mysql
实战派K8S&DB11 小时前
TDSQL 核心模块与进程体系
运维·数据库·分布式·sql·mysql
Lost_the_wind12 小时前
MySQL 学习笔记三
笔记·学习·mysql
腾科IT教育13 小时前
Oracle OCP和MySQL OCP怎么选?方向对比指南
mysql·oracle·ocp·oracle ocp·ocp怎么选·mysql ocp
用户4603812919414 小时前
别人都 commit 了,为什么我的 select 还是旧值?图解 MySQL MVCC
mysql
毕业设计70316 小时前
(免费领源码)django空气净化器销售系统09218- java、PHP、python、C#、小程序、大数据、单片机、网络工程等)
python·scrapy·mysql·pycharm·django·flask·pandas
CJi0NG18 小时前
【自用】MySQL-事务
数据库·mysql
VX_bysjlw98518 小时前
数码设备销售网站设计与实现39138-计算机毕设原创(免费领源码+带部署教程)
java·vue.js·spring boot·mysql·tomcat·mybatis·idea