BadgerDB 初始化必须显式设置 Dir 和 ValueDir,否则会静默创建临时目录导致数据丢失;Gin 中写操作须用显式写事务并正确 Commit/Discard;读取值必须调 ValueCopy(nil) 避免内存失效;进程退出前务必且仅调用一次 db.Close() 防 value log 损坏。

BadgerDB 初始化必须显式设 Dir 和 ValueDir
不设或只设一个路径,badger.Open() 会静默创建临时目录,进程退出后数据就丢了。Gin 启动时若用 badger.DefaultOptions("") 或只传 "/data" 却没配 ValueDir,等于白存。
正确做法是显式拆开并赋值,哪怕路径相同:
opts := badger.DefaultOptions("/var/lib/myapp/badger")opts.ValueDir = "/var/lib/myapp/badger"- 再传给
badger.Open(opts)
别依赖旧版默认行为——v3 已彻底移除隐式 ValueDir 推导逻辑。
Gin handler 里写 Badger 必须用写事务 + Commit
在 router.GET 或 router.POST 里直接调 db.Update() 看似方便,但一旦中间 panic(比如 JSON 解析失败、网络超时),事务不会自动回滚,defer txn.Discard() 也失效。更糟的是,漏传 true 会导致 txn.Set() 直接 panic 报 "cannot perform write on read-only transaction"。
推荐写法:手动控制事务生命周期,配合 error early return:
- 用
txn := db.NewTransaction(true)显式开写事务 - 所有
Set/Delete操作在txn上执行 - 成功后调
txn.Commit();失败前先txn.Discard() - 别在事务里做 HTTP 请求、文件读写等阻塞操作
读取值必须用 ValueCopy(nil),不能直接用 Value()
这是 Gin + Badger 最隐蔽的坑:handler 返回 JSON 前如果直接对 item.Value() 结果做 json.Marshal,大概率返回空或 panic。因为 Value() 返回的是事务内暂存内存切片,事务一结束(Commit 或 Discard 后)地址可能已被复用。
安全写法只有一条:
- 调
val, err := item.ValueCopy(nil)得到独立字节切片 -
nil参数让 Badger 自动分配内存,不用预估长度 - 后续任何操作(包括跨 goroutine 传递、塞进 map、JSON 序列化)都安全
尤其注意 Gin 的 c.JSON(200, map[string]interface{}{"data": val}) 这类写法,val 必须是 ValueCopy 出来的。
进程退出前必须调 db.Close(),且只能调一次
Gin 服务用 signal.Notify 捕获 SIGINT/SIGTERM 时,常有人忘了关 Badger。不关的后果不是“数据延迟落盘”,而是 value log 文件损坏,下次启动直接报 "manifest has unsupported version" 或 "checksum mismatch",整个数据库不可用。
关键点:
- 在
main()末尾或 signal 处理函数里调db.Close() - 确保只调一次——重复调会 panic
- 别把
defer db.Close()放在 handler 里(每个请求都关一次) - 如果用了 Gin 的
engine.Run()阻塞式启动,需另起 goroutine 监听信号
value log 损坏无法修复,只能删库重来。这个动作看起来 trivial,却是生产环境最常被跳过的一步。


















