mgo的One()方法要求传入指向可寻址值的非nil指针；使用未初始化的nil指针（如var result *types.Course）会导致“reflect.Value.Set using unaddressable value”反射错误，而&types.Course{}或new(types.Course)可确保指针有效指向内存地址。
mgo的one()方法要求传入指向可寻址值的非nil指针；使用未初始化的nil指针（如`var result *types.course`）会导致“reflect.value.set using unaddressable value”反射错误，而`&types.course{}`或`new(types.course)`可确保指针有效指向内存地址。
在使用 mgo（已归档但仍在部分遗留项目中广泛使用的 MongoDB 驱动）进行文档查询时，Find().One() 方法常因指针误用引发运行时 panic，典型错误为：
reflect: reflect.Value.Set using unaddressable value
该错误的根本原因在于：One() 内部通过反射对传入参数进行解码赋值，而反射的 Value.Set() 方法仅允许操作「可寻址（addressable）且非nil」的值。
我们来对比两种声明方式：
var result *types.Course // ✅ 类型正确，❌ 值为 nil —— 不指向任何实际内存
result := &types.Course{} // ✅ 类型正确，✅ 指向一个新分配的、可寻址的 struct 实例
result := new(types.Course) // ✅ 等价于上一行：分配零值并返回其地址第一种写法中，result 是一个 nil 指针，One(result) 实际上传入的是 nil。当 mgo 尝试通过反射向 *types.Course 所指位置写入数据时，因目标地址不存在，触发反射限制，抛出 panic。
立即学习“go语言免费学习笔记（深入）”；
✅ 推荐写法（更安全、更符合 Go 习惯）：
func (s Store) Lookup(department string, number string) (*types.Course, error) {
var result types.Course // 声明值类型变量（非指针）
err := s.collection.Find(bson.M{
"department": department,
"course_number": number,
}).One(&result) // 传入其地址 —— 明确、可寻址、非nil
if err != nil {
switch err {
case mgo.ErrNotFound:
return nil, ErrNotFound
default:
log.Error(err)
return nil, ErrInternal
}
}
return &result, nil // 按需返回指针（例如满足接口或避免拷贝）
}这种模式优势明显：
- 避免 nil 指针风险，语义清晰；
- &result 是编译器保证有效的可寻址表达式；
- 若 types.Course 较大，返回 &result 可避免结构体拷贝；
- 符合 Go 标准库（如 json.Unmarshal）的设计惯例：接收 interface{}，内部要求为指向可寻址值的指针。
⚠️ 注意事项：
- 切勿将 One() 与未初始化的指针（如 var p *T）混用；
- 若必须使用指针接收变量，请显式初始化：result := &types.Course{} 或 result := new(types.Course)；
- 在现代 Go 项目中，建议迁移到官方驱动 mongo-go-driver，其 API 更安全（例如 Decode() 方法明确要求 interface{} 且会在运行时校验可寻址性，并返回清晰错误而非 panic）。
总结：One() 不需要你传入一个“已分配的指针变量”，而是需要一个“能被安全写入的内存地址”——最直接的方式，就是传一个值变量的地址（&v）。这是 Go 反射机制与数据库驱动协作时的关键契约。
