本文讲解如何正确将 go 的 error 类型转换为字符串，避免因类型不匹配导致 sql 执行失败，并强调命名规范与类型转换的最佳实践。
本文讲解如何正确将 go 的 error 类型转换为字符串，避免因类型不匹配导致 sql 执行失败，并强调命名规范与类型转换的最佳实践。
在 Go 中，error 是一个接口类型，其核心方法是 Error() string。当你尝试将 error 变量（如 err）直接作为参数传给 db.Exec() 时，数据库驱动无法自动序列化该接口的底层结构（例如 errors.errorString），从而抛出类似 unsupported type errors.errorString, a struct 的错误。
正确的做法是显式调用 .Error() 方法获取其字符串表示：
// ✅ 正确：调用 Error() 方法获取字符串
_, err = db.Exec("UPDATE test SET error = $1 WHERE id = $2", err.Error(), id)
if err != nil {
log.Printf("Failed to save error to DB: %v", err)
return err
}
⚠️ 重要注意事项：
- 避免变量名与类型名冲突：如原代码中使用 error 作为变量名（error := ...），会遮蔽内置类型 error，不仅降低可读性，还可能引发编译错误或意外行为。请始终使用语义清晰的变量名，例如 err, apiErr, parseErr 等。
- 空错误检查：err 可能为 nil，而 nil.Error() 会 panic。务必先判空：
if err != nil {
_, dbErr := db.Exec("UPDATE test SET error = $1 WHERE id = $2", err.Error(), id)
if dbErr != nil {
log.Printf("Failed to persist error: %v (original: %v)", dbErr, err)
}
} else {
// 可选：清空 error 字段或设为 NULL
_, _ = db.Exec("UPDATE test SET error = NULL WHERE id = $1", id)
}
✅ 进阶建议：
- 若需持久化更完整的错误上下文（如堆栈、时间、请求 ID），建议定义结构体并 JSON 序列化后存储；
- 对于生产环境，推荐使用结构化日志（如 zap）记录错误，而非仅依赖数据库字段；
- 使用 fmt.Sprintf("%+v", err) 可获取带堆栈的详细错误（需 github.com/pkg/errors 或 Go 1.13+ 的 errors.As/%w 链式错误支持）。
总之，.Error() 是将 error 安全转为字符串的标准方式，配合良好的变量命名与空值防护，即可可靠地将错误信息持久化到数据库。
