使用GORM与sql-mock编写单元测试遇错误，请求协助

你的单元测试执行报错，大概率是以下几个常见问题导致的，逐一排查：

1. 缺少预期验证步骤 #

你的代码没有在最后调用mock.ExpectationsWereMet()，这是sqlmock的关键步骤——用来验证所有定义的预期操作是否都被执行。没有这一步，即使预期不匹配，也可能只抛出模糊的错误，无法定位问题。

添加代码到测试末尾：

if err := mock.ExpectationsWereMet(); err != nil {
    t.Errorf("未满足所有预期: %v", err)
}

这行代码会输出具体的不匹配信息，比如实际执行的SQL和预期不符、参数不匹配等，是排查的核心手段。

2. SQL语句匹配不精准 #

regexp.QuoteMeta()会转义所有特殊字符，但GORM生成的SQL可能和你写的预期有细微差异：

• 检查表名、字段名的引号：GORM对PostgreSQL的表名/字段名默认会用双引号，但如果你的Student结构体没有设置gorm标签，可能表名的复数/单数规则和预期不一致。
• 字段顺序：GORM生成INSERT语句的字段顺序是按结构体字段的定义顺序，而非你手动编写的顺序，要确保预期SQL的字段顺序和结构体字段顺序一致。
• 空格和换行：GORM生成的SQL可能有多余的空格或换行，用正则匹配时可以忽略这些细节，比如用regexp.MustCompile(INSERT INTO "students" (.) VALUES (.) RETURNING "id")来模糊匹配关键部分。

可以临时在pDb.Create(student)前加上pDb = pDb.Debug()，运行测试时会打印实际执行的SQL，对比你的预期SQL就能快速找到差异。

3. 参数类型不匹配 #

WithArgs(student.ID, student.Name)的参数类型必须和GORM实际传入的完全一致：

• 如果Student.ID是int类型，GORM可能会把它转成int64传入数据库，此时你需要用int64(student.ID)作为参数。
• 字符串类型一般没问题，但要确保Name的非空状态和预期一致（比如是否为nil指针？你的代码里Name是字符串字面量，这部分应该没问题）。

4. GORM模型映射问题 #

检查Student结构体的定义：

• 是否设置了主键标签？比如ID int gorm:"primaryKey"，如果没有，GORM可能不会把ID作为主键，导致INSERT语句的字段或返回值不符合预期。
• 是否自定义了表名？比如结构体有func (Student) TableName() string { return "students" }，如果没有，GORM默认会用复数形式，要确认和预期的表名一致。

5. 事务行为不一致 #

GORM的Create方法默认会开启事务，所以你的mock.ExpectBegin()和mock.ExpectCommit()是合理的，但如果你的GORM配置禁用了默认事务（比如设置了SkipDefaultTransaction: true），就会导致预期不匹配，需要去掉对应的事务预期。

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