直接集成GORM到Kratos可行但需绕过Data初始化陷阱：NewData中db常为nil因未检查gorm.Open错误或遗漏Config关键项；须显式判err、配置NamingStrategy和字段tag、封装DB(ctx)方法透传上下文、用Transaction接口对齐请求生命周期。
直接集成 GORM 到 Kratos 是可行的，但必须绕过 Kratos 自带的 Data 结构体初始化陷阱——很多人卡在 NewData 里没传入正确配置，导致 db 为 nil 或事务失效。
为什么 NewData 初始化后 db 经常是 nil？
常见错误是只调用 gorm.Open 却没检查返回 error，或忽略 gorm.Config 中关键项。Kratos 的 NewData 是一个 Wire provider，它不自动 panic，出错时只返回 error 并让整个服务启动失败（但日志可能被淹没）。
- 必须显式判断
err != nil后立刻 return，不能只 log 然后继续 -
gorm.Config{Logger: ...}若设为log.Silent，SQL 错误不会打印，排查困难 - MySQL 连接字符串漏掉
?parseTime=True&loc=Local会导致 time.Time 扫描失败，报unsupported Scan, storing driver.Value type []uint8 into type *time.Time - PostgreSQL 用户容易忘记加
sslmode=disable（本地开发时），否则连接直接超时
怎么让 GORM 实例支持 Kratos 的 Context 透传？
GORM 本身支持 WithContext(ctx)，但 Kratos 的中间件（如 auth、trace）注入的 context 需要贯穿到 DAO 层。硬编码 r.data.db.WithContext(ctx) 每次都写太冗余，也容易漏。
- 在
data.go的Data结构体中封装一个方法：func (d *Data) DB(ctx context.Context) *gorm.DB，内部做ctx.Value检查是否已有事务 DB（用于后续嵌套事务） - 业务 repo 构造时接收
*Data而非裸*gorm.DB，避免各处重复取 DB 实例 - 不要在 service 层直接调用
db.Create，而应通过 repo 接口，保证 context 可控
事务怎么和 Kratos 的请求生命周期对齐？
Kratos 没有内置事务管理器，GORM 的 Transaction 是函数式 API，需手动绑定到 HTTP/gRPC 请求作用域。常见错误是把事务开在 middleware 里，但没把 tx DB 注入 context，导致 repo 层仍用原 DB。
- 定义 biz 层接口：
type Transaction interface { ExecTx(context.Context, func(context.Context) error) error } - 在
data.go实现该接口，用db.Transaction()包裹，并把 tx DB 存入 context（用私有 key，如type ctxTxKey struct{}） - repo 方法内统一调用
d.DB(ctx)获取当前上下文关联的 DB（事务 or 主库） - 切忌在事务 callback 外部提前 commit/rollback —— GORM 的
Transaction自动处理，手动调会 panic
模型定义和迁移怎么避免表名/字段错乱？
GORM 默认用复数表名 + 下划线命名，而 Kratos 示例项目常建单数表（如 user），不配 NamingStrategy 就查不到数据。
- 在
gorm.Open的Config中固定设置：NamingStrategy: schema.NamingStrategy{SingularTable: true} - 字段 tag 必须显式写
gorm:"column:name"，否则 GORM 会按驼峰转下划线（UserName→user_name），与实际表字段不匹配 - 迁移仅在开发环境用：
db.AutoMigrate(&User{})，生产环境禁用；用db.Migrator().HasTable(&User{})做存在性检查再决定是否跳过 - 主键必须声明：
ID uint64 `gorm:"primaryKey"`，否则 GORM 会额外加id字段，导致插入失败
最易被忽略的是：GORM 的 WithContext 不会自动继承父 context 的 timeout/cancel，如果上层 context 已 cancel，DB 操作仍可能 hang 住。务必在 repo 方法入口加 if err := ctx.Err(); err != nil { return err } 快速退出。
