First查不到数据时返回零值且err为gorm.ErrRecordNotFound，这是GORM将“记录不存在”视为可预期业务状态的设计；需用errors.Is(err, gorm.ErrRecordNotFound)安全判断，而非简单判err!=nil。
First 方法查不到数据时，err 不为 nil，但返回的结构体也不是 nil——它是零值。这不是 bug，是 GORM 的明确设计：把“记录不存在”当作一种**可预期的业务状态**，而非异常。
为什么 First 返回零值 + gorm.ErrRecordNotFound
GORM 不把“没查到”当成错误，而是用哨兵错误 gorm.ErrRecordNotFound 明确标记这个场景。结构体变量（比如 var user User）在传入 First 前已被分配内存，查不到时字段保持零值（0、""、nil 指针等），err 则被设为 gorm.ErrRecordNotFound。
常见误判写法：
if err != nil { /* 误以为所有 err 都要 panic */ }这会导致“查不到用户”被当成严重错误处理，实际可能只是前端请求了一个不存在的 ID。
立即学习“go语言免费学习笔记（深入）”；
正确做法是区分两类问题：
- 真正出错（如连接断开、SQL 语法错）：需要告警或重试
- 查不到记录（
errors.Is(err, gorm.ErrRecordNotFound)）：按业务逻辑走 404 或默认值
怎么安全判断“查不到”而不是“出错了”
必须用 errors.Is，不能用 == 或 strings.Contains ——因为 GORM 可能包装错误（比如嵌套了底层 driver 错误）。
推荐写法：
var user User
err := db.First(&user, 123).Error
if err != nil {
if errors.Is(err, gorm.ErrRecordNotFound) {
// ✅ 明确是“没找到”，不是系统故障
http.Error(w, "用户不存在", http.StatusNotFound)
return
}
// ❌ 其他 err：数据库连不上、权限不足等
log.Printf("查询失败: %v", err)
http.Error(w, "服务暂时不可用", http.StatusInternalServerError)
return
}注意：gorm.ErrRecordNotFound 是包级变量，需导入 gorm.io/gorm 并显式引用。
替代方案：用 Find + 切片避免零值干扰
如果不想和零值打交道，直接用切片接收：
var users []User
err := db.Where("id = ?", 123).Find(&users).Error
// err == nil 总是成立（查不到也返回 nil）
if len(users) == 0 {
// 明确无结果
}
// 有结果则取 users[0]
优点：
- 无需判断错误类型，逻辑更直白
- 避免结构体字段零值带来的歧义（比如
Age: 0究竟是数据库存的 0，还是没查到导致的零值？）
缺点：
- 多一次内存分配（哪怕只查一条）
- 语义上略冗余（你本意就是查单条）
容易被忽略的坑：结构体字段首字母小写导致扫描失败
如果 User 定义里字段是小写（如 name string），GORM 反射时无法写入，最终 user 全是零值，且 err 仍为 nil（因为 SQL 执行成功了，只是赋值失败）。这时 errors.Is(err, gorm.ErrRecordNotFound) 永远不成立，你以为“查到了”，其实全是空数据。
检查方法：
- 结构体字段必须大写开头（
Name string） - 或加 GORM tag 显式指定列名：
Name string `gorm:"column:name"` - 运行时打印
db.Debug().First(&user, 1).Error看日志是否出现Scan error on column index
零值本身不可怕，可怕的是它掩盖了字段不可导出这个根本问题。
