Firestore客户端离线错误 应用休眠恢复后无法获取文档如何解决？

问题根因 #

该报错出现在应用退后台触发OnSleep后恢复、或长时间冷启动场景时，本质是Firestore SDK内部连接状态标记异常：SDK在应用退后台时会主动断开长连接降低资源消耗，前台恢复时部分场景下内部状态重置失败，错误将客户端标记为离线状态，读操作默认优先走本地缓存就会触发该报错。
而写操作默认会进入本地队列等待网络恢复后自动同步，所以才会出现报离线但能正常写入的矛盾情况。你提到的重新进入功能模块就能恢复，本质是页面重建时触发了Firestore实例状态重置，被动完成了网络重连。

可落地修复方案 #

• 你提到的在应用恢复运行时调用EnableNetworkAsync的方案是可行的，建议直接把该逻辑加到应用OnResume生命周期回调中，前台恢复时主动触发Firestore重建网络连接，提前修正异常的状态标记。
• 调用EnableNetworkAsync不需要强制等待固定时长，有条件可以搭配监听Firestore的网络状态回调，确认连接恢复后再执行后续文档查询操作；如果业务适配成本高，加1~2秒的等待兜底也可以覆盖绝大多数异常场景。
• 可以额外在查询逻辑的异常捕获分支加降级逻辑：捕获到该离线报错时，先执行一次EnableNetworkAsync后重试1次查询，覆盖剩余偶发的状态异常场景。

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