badgerdb需显式导入并严格配置才能启用：config.metadatastorage必须为小写"badger"，go.mod需含github.com/dgraph-io/badger/v4，datapath须为空目录，且需验证生成.vlog等特征文件。
直接用 plugin.Storager 就能跑，但 BadgerDB 实际没被真正启用——GoFly 框架里默认走的是 BoltDB，即使你把 MetadataStorage 配置成 "badger"，也得确认插件底层真加载了 Badger 实现，否则调用会 panic 或静默失败。
确认 BadgerDB 是否实际生效
GoFly 的 storage 插件是“双库共存但单活”设计：代码里有 Bolt 和 Badger 两套实现，但运行时只加载其中一个。关键看 utils/plugin/storage/init.go 中的初始化逻辑——它根据 config.MetadataStorage 字符串值，用 switch 分支决定调用哪个 NewStorager() 函数。
常见踩坑点：
-
config.MetadataStorage写成"Badger"或"badgerdb"都不行，必须严格是"badger"（小写，无后缀） - 如果项目里没显式 import
github.com/dgraph-io/badger/v4，Go 编译时不会打包 Badger 相关代码，init.go的 badger 分支会被编译器剔除，最终 fallback 到 Bolt - Badger 要求数据目录存在且可写，而 Bolt 对不存在的路径会自动创建；Badger 报错常是
mkdir /path/to/badger: permission denied或open /path/to/badger/LOCK: no such file or directory，其实都是路径问题
手动切换到 BadgerDB 的三步实操
别依赖插件“自动识别”，直接改初始化入口更可靠：
- 打开
utils/plugin/storage/init.go，找到类似switch config.MetadataStorage的块，在case "badger":分支里确认返回的是badger.NewStorager(...)，不是空结构体或 panic - 确保
go.mod里有github.com/dgraph-io/badger/v4 v4.2.1（v4 是当前稳定版，v3 已归档，v5 尚未 release） -
DataPath必须指向一个**空目录**（Badger 不允许复用已有 Bolt 数据文件），比如设为"./data/badger"，然后手动mkdir -p ./data/badger
验证方式：启动服务后，检查该目录下是否生成了 000000.vlog、MANIFEST 等 Badger 特征文件，而不是 .db 文件。
BadgerDB 和 BoltDB 的行为差异要点
两者 API 表面一致，但底层语义不同，直接影响你的调用逻辑：
-
Get()返回nil, nil表示 key 不存在（Badger），而 Bolt 返回nil, ErrBucketNotFound或nil, ErrKeyNotFound—— 所以判断“key 不存在”不能只看返回值是否为 nil，得检查 error -
List()在 Badger 中本质是遍历 prefix，不支持 offset/limit 原生分页；插件里做的内存分页，大数据量时会 O(n) 扫描，比 Bolt 的 cursor 迭代慢 - Badger 支持
ValueLogFileSize和MaxTableSize等性能调参，Bolt 没这些；但 Badger 默认开启SyncWrites: true，写入延迟更高，开发期可设为false提速（仅限非关键数据）
为什么你的 Set() 看似成功却查不到数据？
Badger 的事务模型更严格：插件封装的 Set() 方法内部用了 Update()，但如果事务中途 panic 或被 defer recover 捕获，Badger 会静默丢弃写入，也不报错。最典型的场景是 key 字符串含控制字符（如 \x00）、或 value 超过 16MB（Badger 默认限制）。
排查建议：
- 在
Set()后加一行log.Printf("set key=%q len=%d", key, len(val))，确认 key/value 合法 - 临时把
plugin.Storager.Set()替换为裸 Badger 调用：db.Update(func(txn *badger.Txn) error { return txn.Set([]byte(key), val) })，观察 error 输出 - Badger 的
View()只读事务无法看到本事务未提交的写，所以不要在同一个事务里Set后立刻Get，除非用GetOrSet()或拆成两个事务
真正麻烦的不是集成步骤，而是 Badger 对数据合法性和事务边界的敏感度远高于 Bolt——一个看似无关的 JSON 序列化错误，都可能让整个写入静默失效。
