初始化 RocksDB 实例应调用 rocksdb::DB::Open() 并显式配置 rocksdb::Options：需设 create_if_missing=true、error_if_exists=false（调试时可关）、env=rocksdb::Env::Default()，否则易因路径或平台问题崩溃。
怎么初始化 RocksDB 数据库实例
直接调用 rocksdb::DB::Open() 是最常见方式，但参数结构体 rocksdb::Options 必须显式配置，否则默认行为在生产环境极不安全。
常见错误是忽略 create_if_missing 和 error_if_exists 的组合逻辑——比如想清空重试却没关 error_if_exists，结果报 IO error: While lock file；或者误开 create_if_missing = false 却传入新路径，直接返回 Invalid argument 错误。
-
options.create_if_missing = true：路径不存在时自动建目录（推荐开发期开启） -
options.error_if_exists = false：避免重复打开已存在 DB 时崩溃（调试时可关，上线建议开） - 务必设置
options.env = rocksdb::Env::Default()，否则某些平台（如 Android）可能因线程局部存储问题导致随机 crash
写数据时为什么 WAL 没生效或性能卡住
rocksdb::WriteOptions 控制单次写入行为，sync = true 并不等于“立刻落盘”，它只保证 WAL 刷到 OS 缓存；真正刷盘依赖 options.use_fsync = true（Linux）或 options.use_os_buffer = false（跨平台更稳）。
高频小写场景下，盲目开 sync = true 会让吞吐暴跌 10 倍以上。但若关掉，进程崩溃就丢最近一批未刷 WAL 的写入——不是所有业务都能接受。
立即学习“C++免费学习笔记（深入）”；
- 批量写优先用
rocksdb::WriteBatch+Write()，比单 key 循环快 5–20 倍 - 确认是否启用了 WAL：
write_options.disableWAL = false（默认 true？错，默认是 false，但部分旧版本文档写反了） - 如果用
SyncPoint做测试注入，注意它只在 debug build 生效，release 下无效
读取时 Key 找不到但确认写过，怎么排查
最常踩的坑是字符串编码/二进制边界问题：std::string 构造时若含 \0 字节，C++ 字符串长度正常，但 RocksDB 内部按字节比较，而某些调试打印函数（如 printf("%s", key.data())）会截断——你以为 key 是 "abc"，实际是 "abc\0def"，查不到纯属自然。
另一个隐蔽点是 comparator：默认用字典序，但如果你自定义了 rocksdb::Slice 比较逻辑（比如倒序、时间戳前缀），而读写时没统一用同一个 options.comparator 实例，就会出现“能写不能读”。
- 打印 key 长度和十六进制内容：
printf("key len=%zu hex=%s", key.size(), rocksdb::Slice(key).ToString(true).c_str()) - 确保
options.comparator在 Open 时传入，且 comparator 对象生命周期 > DB 实例 - 用
Get()返回rocksdb::Status::IsNotFound()判断缺失，别用返回值是否为空字符串
编译链接时报 undefined reference 到 rocksdb::DB::Open
不是头文件没 include，而是链接顺序和符号可见性问题。RocksDB 默认编译为静态库（librocksdb.a），但它的依赖（如 libz、libbz2、liblz4）必须放在链接命令末尾，否则 GNU ld 会丢弃未解析符号。
另外，CMake 用户容易漏掉 target_link_libraries(your_target PRIVATE rocksdb) 中的 PRIVATE ——若写成 PUBLIC 或 INTERFACE，下游 target 可能因缺少 -lstdc++fs（C++17 filesystem）等间接依赖而链接失败。
- 检查
nm -C librocksdb.a | grep DB::Open确认符号存在 - 链接命令中，
-lrocksdb必须在所有它依赖的库（-lz -llz4 -lbz2）之后 - 启用
ROCKSDB_LITE=1编译时，DB::Open会被裁掉，改用DB::OpenForReadOnly或其他轻量接口
rocksdb::Env 子类替换、内存分配器定制、压缩算法开关这些点，一个没对齐，运行时就静默失败。 
