登出切换用户仍显示旧文档：Couchbase Lite 1.4.0求助

嘿，这个问题我之前在项目里碰到过！Couchbase Lite 1.4.0版本在用户切换时确实有几个容易踩的坑，结合你说的操作，我给你梳理几个关键的修复点：

1. 复制器不能只停，要彻底“送走” #

单纯调用stop()有时候不够——1.4.0的复制器可能还在后台处理pending的同步任务，甚至因为监听器没移除导致内存泄漏，一直在偷偷跑。你得这么做：

• 调用stop()后，一定要等复制器状态变成STOPPED（可以加个循环或者监听状态回调确认）
• 把所有注册的复制器监听器都移除掉，别留尾巴
• 最后把复制器实例置为null，让GC能彻底回收它

给你个伪代码参考：

// 假设你的复制器是replicator实例
replicator.stop();
// 等它真的停下来
while (replicator.getStatus().getState() != ReplicatorState.STOPPED) {
    Thread.sleep(100);
}
// 移除所有监听器
replicator.removeChangeListener(yourChangeListener);
// 彻底清空
replicator = null;

2. 数据库删除要连根拔起，别留碎文件 #

你说删了数据库，但1.4.0的数据库不是单个文件，是一整个目录（包含.wal、.shm这些辅助文件）。只删主数据库文件的话，残留的碎文件会导致新用户登录时读出旧数据：

• 先调用database.close()，然后确认database.isOpen()返回false
• 直接删除数据库所在的整个目录，而不是单个文件
• 每个用户要用独立的数据库目录！别复用同一个目录给不同用户，哪怕你删了旧文件也容易出问题

3. 视图重建得“先清后建”，还要等它完工 #

重建视图的时候，别只调用createIndex()，得先把旧索引清干净：

• 先执行view.deleteIndex()删掉旧索引
• 再调用view.createIndex()重建
• 一定要等索引构建完成！可以用view.waitForIndexes()方法阻塞到索引建好，或者监听索引的变化事件
• 新用户查询时，务必加上channel过滤：query.setChannels(Collections.singletonList(newUserId))，确保只查当前用户的文档

4. 别忘了清应用层的缓存！ #

有时候锅不在Couchbase Lite，是你自己的UI或者ViewModel缓存了旧数据：

• 登出时立刻清空所有显示文档的UI组件的数据源（比如RecyclerView的Adapter数据集）
• 新用户登录后，所有查询数据库的代码要重新初始化，别复用旧的查询实例或者缓存的结果集
• 如果用了状态管理类（比如ViewModel、LiveData），登出时一定要重置这些状态

5. 强制刷新本地文档缓存 #

Couchbase Lite的本地文档（比如用户配置）可能残留旧数据，登出时可以：

• 删除旧用户的本地文档：database.deleteLocalDocument(oldUserId)
• 调用database.invalidateAllDocs()强制刷新本地文档的缓存

按这个顺序走一遍，应该就能解决旧文档残留的问题了——1.4.0版本对资源释放的要求比较严格，每一步都得做扎实，不能偷懒。

内容的提问来源于stack exchange，提问作者Shyam