使用GORM与SQLMock测试时查询匹配失败问题求助

1. 检查自定义类型与GORM字段配置 #

GORM 1.22+对自定义类型的序列化逻辑做了调整，你的ActionType或Meta字段可能因配置不兼容导致参数生成异常：

• 若Meta是JSON类型字段，确保标签为gorm:"type:json;default:null"，且该类型实现了driver.Valuer和sql.Scanner接口，或直接使用GORM内置的gorm.JSON类型。
• 自定义ActionType必须正确实现Valuer和Scanner接口，否则GORM无法将其转为有效SQL参数，会直接生成NULL。

2. 调整SQLMock的预期匹配逻辑 #

GORM 1.25优化了SQL生成逻辑，零值字段的占位符处理方式与旧版本不同：

• 不要硬编码参数位置（如$8），改用sqlmock.AnyArg()匹配动态参数，或用sqlmock.MatchRegexp匹配SQL结构而非精确占位符顺序。示例：

  mock.ExpectExec(regexp.QuoteMeta(`INSERT INTO "incentive_actions"`)).
    WithArgs(sqlmock.AnyArg(), sqlmock.AnyArg(), ..., sqlmock.AnyArg()).
    WillReturnResult(sqlmock.NewResult(1, 1))
  

3. 修正GORM Create方法的调用策略 #

新版本GORM对零值字段的插入策略有变化，检查你的插入代码：

• 若Meta是零值（如nil空结构体），GORM 1.25默认不会将其作为参数传入，而是写NULL。可以显式添加OmitZero(false)强制包含零值字段：

  db.Create(&incentiveAction).OmitZero(false)
  

• 或用Select方法明确指定插入字段列表，确保Meta被包含：

  db.Select("action_type", "meta", ...).Create(&incentiveAction)
  

4. 升级SQLMock版本 #

SQLMock 1.5.2可能未适配GORM 1.25的SQL生成逻辑，尝试升级到最新稳定版（如v1.5.4+），新版本通常会跟进ORM的语法变化。

5. 开启GORM日志排查SQL差异 #

开启GORM的SQL日志，查看实际执行的SQL语句，对比与SQLMock预期的差异：

db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{
  Logger: logger.Default.LogMode(logger.Info),
})

根据日志中的SQL结构，调整SQLMock的预期匹配规则。

内容的提问来源于stack exchange，提问作者AmirReza