必须先初始化rados_t实例并调用rados_connect()，检查返回值是否为0；接着用rados_conf_read_file()或rados_conf_set()配置mon_host、keyring和client_id；再调用rados_ioctx_create()创建IO上下文，最后用rados_write()/rados_read()完成对象读写。
如何用 C++ 连上 RADOS 集群并完成基础读写
必须先初始化 rados_t 实例，再调用 rados_connect()；不检查返回值或跳过配置加载，rados_connect() 会静默失败，后续所有操作都返回 -ENOTCONN。
典型流程是：构造 rados_t → rados_conf_read_file() 或 rados_conf_set() 设置 mon_host、keyring、client_id → 调用 rados_connect() → 检查返回值是否为 0。
-
mon_host必须是逗号分隔的 IP:PORT 列表（如"192.168.1.10:6789,192.168.1.11:6789"），不能带ceph://前缀 - 若用
keyring文件，路径需绝对且进程有读权限；若用cephx密钥字符串，要用rados_conf_set(r, "key", "AQ...==") - 未显式设置
client_id时默认为admin，但生产环境应指定独立 client 名并配对应权限
怎么在 C++ 里打开并读写一个 RADOS 对象（非 RBD）
RADOS 客户端操作的是裸对象（object），不是块设备；RBD 是构建在其上的高层封装。直接读写对象需用 rados_ioctx_create() 创建 IO 上下文，再用 rados_write() / rados_read()。
注意：rados_write() 是覆盖写，不支持追加；若要模拟追加，得自己管理偏移并用 rados_write_full() 或分片写入后合并。
立即学习“C++免费学习笔记（深入）”；
- IO 上下文必须绑定到已有 pool，创建前用
rados_pool_lookup()确认 pool 存在，否则rados_ioctx_create()返回-ENOENT -
rados_read()的缓冲区需提前分配好内存，长度参数是最大可读字节数，返回值才是实际读取字节数；若返回-ENOENT，说明对象不存在，不是读错位置 - 写入大于 4MB 的数据时，底层会自动分片，但单次
rados_write()调用仍受限于内存和网络缓冲，建议分块控制在 1–2MB
为什么 rados_write() 成功但 rados_read() 读不到数据
最常见原因是对象写入后没等 OSD 提交就立即读 —— RADOS 默认是异步写，rados_write() 返回仅表示已发往集群，不保证落盘。
解决方法只有两个：要么用 rados_write_full()（同步阻塞直到提交），要么在写后调用 rados_aio_wait_for_complete() 等待异步上下文完成。
-
rados_write_full()会先清空对象再写入，适合整对象替换场景；若只想更新部分内容，必须用普通rados_write()+ 异步等待 - 使用异步写时，必须用
rados_aio_create_completion()创建 completion，并传给rados_aio_write()，不能复用 completion 实例 - 忘记调用
rados_aio_release()会导致内存泄漏，且后续rados_aio_wait_for_complete()可能卡死
C++ 中如何安全释放 RADOS 资源避免崩溃
资源释放顺序非常关键：rados_ioctx_destroy() 必须在所有对该 IO 上下文的读写完成后调用；rados_shutdown() 必须在所有 rados_ioctx_destroy() 之后，且只能调用一次。
如果在还有 pending 异步操作时调用 rados_ioctx_destroy()，程序大概率 SIGSEGV；若重复调用 rados_shutdown()，部分版本会 abort。
- 每个
rados_ioctx_t对应一个 pool，不要跨 pool 复用同一个 IO 上下文 - 用 RAII 封装时，析构函数里先
rados_aio_wait_for_complete_all()等待全部异步完成，再rados_ioctx_destroy() -
rados_shutdown()应放在整个程序生命周期末尾，比如 main() 结束前，或单例类的最终清理逻辑中
异步操作的生命周期管理比同步操作复杂得多，尤其在多线程环境下，completion 回调里的变量捕获、异常处理、以及 completion 本身的释放时机，稍不注意就会踩到 use-after-free 或 double-free。
