GORM在Go微服务中必须规避默认陷阱：连接池需显式设MaxIdleConns（10+）、MaxOpenConns（50+）和ConnMaxLifetime（30min），模型字段须显式tag声明，禁用生产环境AutoMigrate，事务须手动控制Commit/Rollback，关联查询慎用Preload防N+1。
直接上结论：GORM 在 Go 微服务中不是“能不能用”，而是“怎么避免踩坑地用”——它默认行为友好，但连接池、事务边界、模型定义和迁移策略稍有偏差，就会在高并发或分布式场景下暴露数据不一致、连接耗尽、表结构错乱等问题。
gorm.Open 连接时必须显式配置连接池
很多人只写 gorm.Open(mysql.Open(dsn), &gorm.Config{})，却忘了底层 sql.DB 的连接池默认值极小（MaxIdleConns=2，MaxOpenConns=0 即无上限），微服务一压测就报 dial tcp 127.0.0.1:3306: connect: cannot assign requested address 或超时。
- 必须调用
db.DB().SetMaxIdleConns(10)和db.DB().SetMaxOpenConns(50)，数值按服务 QPS 和数据库规格调整，不要硬编码成固定值 -
SetConnMaxLifetime(30 * time.Minute)和SetConnMaxIdleTime(10 * time.Minute)要配对设，避免长连接被 MySQL 的wait_timeout中断后 GORM 不重连 - 如果用的是连接池中间件（如 go-sql-driver/mysql 的
interpolateParams=true），注意 DSN 中不能含%字符，否则解析失败
模型定义里别信“约定优于配置”的默认行为
GORM 默认把 UserID 映射成 user_id 字段、CreatedAt 自动设为 created_at 并加 NOT NULL，但在已有表或跨团队协作时，这些“智能”反而导致字段缺失或类型错配。
- 所有关键字段都显式加 tag：
ID uint `gorm:"primaryKey;column:id"`，避免主键名/类型被误推 - 时间字段务必指定类型：
CreatedAt time.Time `gorm:"column:created_at;type:datetime;not null"`，MySQL 8+ 和低版本对datetime精度处理不同 - 软删除字段用
DeletedAt gorm.DeletedAt `gorm:"index"`，但要确认业务是否真需要软删——硬删 + 归档表更易审计 - 外键关联字段（如
Order.UserID）必须加gorm:"index"，否则 JOIN 查询性能骤降
事务不能只靠 defer tx.Rollback()
微服务里常见写法是 tx := db.Begin(); defer tx.Rollback()，但 panic 捕获不全、recover 位置错、或嵌套事务没显式 Commit，都会导致事务卡住或静默失败。
立即学习“go语言免费学习笔记（深入）”；
- 用
defer func() { if r := recover(); r != nil { tx.Rollback() } }()只能捕获本 goroutine panic，跨协程失效 - 真正安全的做法是：事务逻辑封装进函数，返回 error，由调用方统一
if err != nil { tx.Rollback() } - 嵌套事务（比如 A 调 B，B 也开事务）要用
Session(&gorm.Session{NewDB: true})隔离，否则Commit()会提前提交外层事务 - 分布式事务场景下，GORM 本身不提供两阶段提交，必须配合 Saga 或消息表，
tx.Create()后立刻发 MQ，失败则本地回滚 + 补偿
AutoMigrate 在生产环境必须禁用
开发期用 db.AutoMigrate(&User{}) 很方便，但上线后自动改表结构等于把 DDL 当成 runtime 行为——字段类型变更、索引增删、主键调整都可能锁表，微服务滚动发布时旧实例还在读老结构，新实例已写新字段，直接崩。
- CI/CD 流水线里用
migrate工具（如 gormigrate、golang-migrate）生成 SQL 迁移脚本，人工审核后执行 - 模型 struct 变更后，必须同步更新 migration 文件，不能只改代码
- 如果真要用 AutoMigrate（如内部工具链），至少加
gorm.Config{DisableForeignKeyConstraintWhenMigrating: true}避免 MySQL 8.0+ 因外键冲突中断 - 每次启动时检查
db.Migrator().HasTable(&User{})是否存在，不存在才跑 migrate —— 但仅限单实例部署，K8s 多副本必须串行化
最常被忽略的一点：GORM 的 Preload 和 Joins 在关联查询时生成的 SQL 完全不同，前者 N+1，后者可能丢数据；用错一个参数，线上查 10 万条记录就 OOM。别图省事，先 explain，再决定用哪个。
