在 Fiber 中应全局单例初始化 *gorm.DB,禁用无条件 Delete,GORM 查询需显式判断 gorm.ErrRecordNotFound 并返回 404,避免误转为 500 错误。

直接集成 Fiber + GORM 是可行的,但必须手动管理 DB 生命周期和请求上下文传递,Fiber 本身不提供 ORM 绑定机制。
怎么在 Fiber 中安全初始化并复用 *gorm.DB
Fiber 是无状态 HTTP 路由器,*gorm.DB 必须作为全局单例或依赖注入对象持有,不能每次请求都 gorm.Open。常见错误是把 db 声明在 handler 内部,导致连接泄漏或 panic。
- 用
sync.Once或init()初始化一次*gorm.DB,并在main()中调用AutoMigrate - 务必设置连接池:
db.DB().SetMaxIdleConns(10)和db.DB().SetMaxOpenConns(100) - 别把
*gorm.DB直接塞进fiber.Ctx.Locals—— 它不是 request-scoped 资源,而是共享实例 - 如果要用依赖注入(如 wire),确保
*gorm.DB构造早于路由注册
如何把 GORM 查询逻辑接入 Fiber handler
Fiber 的 fiber.Handler 签名是 func(*fiber.Ctx) error,GORM 方法返回 error,但语义不同:GORM 的 err 可能是记录未找到、约束冲突或连接失败,而 Fiber handler 的 error 会触发默认 500 响应 —— 这会导致 gorm.ErrRecordNotFound 被误判为服务端错误。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 所有
First/Take查询后,必须用errors.Is(err, gorm.ErrRecordNotFound)显式判断“未找到”,再返回c.Status(404).JSON(...) - 别写
if err != nil { return err }—— 这会让 404 变成 500 - 更新操作优先用
db.Model(&u).Where("id = ?", id).Updates(map[string]interface{}{"status": 0}),避免传 struct 触发零值跳过 - 插入时若字段含零值(如
Price: 0.0),必须加db.Select("name", "price").Create(&u)
为什么 Delete 不加条件会清空整张表
Fiber 路由里写 db.Delete(&User{}) 是高危操作,GORM 默认作用域是全表,等价于 DELETE FROM users。这不是 Fiber 的问题,而是 GORM 的设计行为。
立即学习“go语言免费学习笔记(深入)”;
- 永远用带主键的实例删除:
db.Delete(&user)(前提是user.ID已赋值) - 或显式加 WHERE:
db.Where("id = ?", id).Delete(&User{}) - 软删除字段(如
DeletedAt)存在时,Delete默认只软删;真删必须Unscoped().Delete,且需二次确认 - 线上环境建议在 GORM 配置中启用
AllowGlobalUpdate: false,让无条件Delete/Update直接 panic
最易被忽略的是错误类型区分 —— gorm.ErrRecordNotFound 和网络超时、事务冲突的 error 在底层都是 error 接口,但业务含义天差地别。Fiber 不会帮你做这层语义解析,漏判就等于把用户输入错误当成系统崩溃处理。

















