做 APP 定制开发时，弱网、断网、切后台几乎无法避免。典型现象是：列表页刚才还能看，进电梯后一片空白；用户在离线状态下填了表单，回到网络却没提交成功；或者同一个订单在两台设备上显示不同状态。这类问题的根因往往不在网络本身，而在缓存策略与同步策略没有在设计阶段定清楚。
下面按「现象 → 可能原因 → 排查方向」展开，最后给出排查顺序与自查清单，可以直接对照项目使用。
现象一：断网后页面空白或数据缺失
断网后读不到数据，常见原因是所有数据都依赖实时接口，本地没有可用的缓存层。缓存不是简单把接口返回写给本地存储就行，还要区分哪些数据可以旧一点、哪些必须实时。
可能原因：缓存粒度太粗，整页数据序列化后一把写入，字段变化后无法局部更新；或缓存只存在内存，进程被系统回收就丢失；也可能缓存了但读取时没有做版本校验，读到脏结构直接解析失败。
设计建议：按业务实体缓存，比如订单、字典、用户资料分别存储；为缓存带上版本号与写入时间；列表页可先渲染缓存再异步刷新，详情页对时效敏感的数据明确标注来源与更新时间。判断标准是：断网时用户还能完成哪些操作，这个范围要在需求阶段就和业务方确认。
现象二：离线操作回网后没有提交成功
离线提交失败，一般是缺少待发送队列，或者队列在应用重启后丢失。正确的做法是把用户操作写成一条本地待办记录，联网后按顺序重放。
排查要点：
- 操作是否落盘：只放在内存队列里，杀进程即丢。
- 是否可重试：需要区分可重试错误（超时、断网）与不可重试错误（参数校验失败、无权限），后者重试多少次都没用，应转人工处理。
- 是否幂等：同一条操作被重放两次，服务端要能识别。这部分与方法设计有关，可参考我们整理的技术实现细节中关于幂等处理的说明。
- 顺序是否被破坏：同一实体的新增与修改若乱序发送，容易产生覆盖。
现象三：多端数据不一致或互相覆盖
多端不同步，通常是没有定义冲突解决规则。两端各自基于旧数据修改，最后写入的覆盖了先写入的，用户看到的就是「我改的东西不见了」。
常见取舍：字段级合并适合表单类数据，但实现复杂；版本号或时间戳比对适合结构化记录，实现简单但会丢掉部分修改；重要业务建议由服务端返回冲突，让用户确认。
这里没有通用答案，取决于业务对数据准确性的要求。审批类流程数据一般不宜自动合并，宁可提示冲突；配置类、字典类数据则可以接受以服务端为准。涉及与 ERP、HR 等后台系统对接时，冲突规则还要和对方的更新节奏对齐，具体可参考软件定制开发与系统集成服务中接口设计的做法。
现象四：同步耗电、流量大或频繁卡顿
同步策略过于激进会让 APP 变卡。全量拉取、频繁轮询、每次前后台切换都触发一次同步，都是常见诱因。
建议按增量方式设计：客户端带上本地游标，服务端只返回变化部分；下拉刷新与自动同步分开控制；批量接口设置合理的分页与合并条件。移动端还要考虑系统对后台任务的限制，切后台时不要假设一定能执行完同步。运维侧可以观察接口耗时与失败率，`Nginx` 访问日志与客户端埋点是常用的判断依据，云上部署的监控配置可参考服务范围与交付流程中的运维环节说明。
推荐的排查顺序
现场出问题时，建议按下面的顺序逐项确认，避免一开始就怀疑服务端：
- 复现环境：确认是断网、弱网、切后台还是杀进程导致，记录机型与系统版本。
- 造数据验证：用固定的缓存样本启动，判断是否读取环节出错。
- 看队列：检查待发送记录是否存在、状态是否卡在失败、是否进入死循环重试。
- 比对服务端：用同一账号在另一台设备核对数据，确认是本地脏还是服务端未更新。
- 看冲突日志：确认是否有版本比对失败与覆盖写入。
- 看同步触发点：确认同步是被哪个事件触发的，是否存在并发同步。
- 回看发布变更：缓存结构、接口字段、同步时机最近是否改动过。
预防措施与自查清单
比起事后排查，更省成本的是在开发前期把这些约定写进技术方案。我们做过的同类项目见互联网与软件行业案例，多数线上问题都能追溯到早期没有约定清楚。
- 缓存分层是否明确：静态字典、列表、详情分别缓存多久，由谁决定失效。
- 缓存结构是否带版本号，升级后旧缓存能否安全丢弃。
- 离线操作是否落盘，队列在应用重启后是否可恢复。
- 每条离线操作是否幂等，服务端是否具备去重能力。
- 是否区分可重试与不可重试错误，失败任务能否转人工。
- 冲突规则是否书面确认，重要数据是否禁止静默覆盖。
- 同步是否增量进行，是否有并发控制与退避重试。
- 用户在界面上能否看到同步状态与失败原因。
- 弱网测试、断网测试、切后台测试是否进入验收用例。
- 线上是否有可追踪的日志与异常上报，方便定位。
常见问题
问：是不是所有 APP 都需要离线缓存？
不一定。数据时效要求高、变更频繁的场景，可以只做短时缓存和失败重试。是否做离线写入，取决于业务能否容忍延迟提交。
问：缓存放在本地存储会不会有安全问题？
需要评估数据敏感度。登录凭证与个人信息不建议明文落盘，敏感数据可加密存储并设置有效期，退出登录时清理相关缓存。
问：前后端谁来定同步规则？
建议由双方共同确认：客户端提出离线场景，服务端给出幂等与冲突处理方案，最终形成接口约定，纳入联调验收范围。
