必须处理事务落盘、并发安全、结构组织三件事，否则重启丢数据、高并发写乱序、查不到旧记录；需用db.Update确保commit、View做只读、分bucket设计key、绝对路径+0600权限初始化。
直接用 bolt.Open 打开文件、建 bucket、调 Put/Get 就能跑起来，但真要落地成可靠本地存储，必须处理事务落盘、并发安全、结构组织这三件事——否则重启丢数据、高并发写乱序、查不到旧记录都是常态。
初始化数据库时必须设对权限和路径
BoltDB 文件本质是 mmap 映射的普通文件，权限不对会报 permission denied 或静默失败；路径含相对符号（如 ../data.db）在服务化部署时容易指向错位置。
-
bolt.Open("data.db", 0600, nil)是最安全的起手式：仅当前用户可读写，避免被其他进程误改 - 路径建议用绝对路径，可通过
filepath.Abs("data.db")转换，尤其在 systemd 或 Docker 中运行时 - 不要复用已打开的
*bolt.DB实例跨 goroutine 写，BoltDB 允许多 reader，但只允许一个 writer —— 并发Update会排队阻塞，不是 panic
写入必须走 Update 且不能省略 tx.Commit()
很多人以为 Put 调完就落盘了，其实不然：Update 函数内部才真正 commit；如果手动开了 tx 却忘了 Commit()，数据只存在内存页里，进程退出即消失。
- 正确写法：用
db.Update(func(tx *bolt.Tx) error { ... })，函数返回 nil 时自动 commit - 错误写法：自己调
db.Begin(true)→Put→ 忘记tx.Commit()，或 defertx.Rollback()后没做任何事 - 批量写入别拆成多个
Update：100 条消息用 1 次Update+ 100 次Put，比 100 次独立Update快 5–10 倍
读取要用 View，别在 Update 里只读不写
Update 会获取写锁，哪怕你只调 Get 不调 Put，也会阻塞其他写操作。高频读场景下，这会让整个 DB 变慢。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 只读逻辑一律用
db.View(func(tx *bolt.Tx) error { ... }) -
View内部不能调Put或CreateBucket，否则 panic 报tx is not writable - 如果读+写耦合（比如“查是否存在→不存在则插入”），必须用
Update，但要把判断和插入写在同一个事务里，避免竞态
Bucket 和 key 设计决定后期能不能查、好不好维护
BoltDB 没有索引、不支持 SQL 查询，所有“查询能力”都靠你设计 bucket 名和 key 格式撑起来。比如想按时间范围扫日志，key 就得用时间戳前缀；想按用户 ID 查，bucket 最好按 user_123 分片。
- 避免把所有数据塞进一个
bucket：不同业务类型分 bucket，比如"users"、"events"、"config" -
key推荐用[]byte编码，别用字符串拼接：用binary.BigEndian.PutUint64(buf, ts)比fmt.Sprintf("%d", ts)更紧凑、可排序 - 值序列化推荐
gob（Go 原生、快）或json（跨语言友好），但注意gob不兼容结构体字段增减
最容易被忽略的是：BoltDB 的 bucket 一旦创建就不能删，key 删除后空间不会立即回收——它只是标记为“可复用”。如果你频繁写入再删除小 key，长期运行后文件体积只增不减。真要收缩，得用 db.Copy() 导出新文件。
