iCloud 同步卡住的故障排查

Paper Scanner 的 iCloud 同步出现卡住（通常表现为上传数量在数分钟内不变化）时，原因几乎总归为 iOS 端的以下四种配置或系统状况之一。以下排查清单按出现频率排序，并附每种的验证方法。

1. Paper Scanner 的 iCloud 云盘未启用

两个独立的开关必须同时打开，任一关闭都会导致 Paper Scanner 排队上传而被 iOS 默默拒绝，使状态栏停在初始数字。

• iOS 设置 → 你的名字 → iCloud → 显示全部 → Paper Scanner 必须打开。
• iOS 设置 → Paper Scanner → iCloud 云盘 必须打开。

第二个开关是最常被遗漏的。两个设置相互关联但彼此独立；上传正常进行需两者均启用。

2. iOS 在节流后台同步

iOS 在以下两种情况下限制后台 iCloud 活动：

• 开启了低电量模式。 在 iOS 设置 → 电池中关闭。低电量模式开启时，iOS 会推迟或暂停后台上传以节省电量。
• iPhone 存储空间接近满载。 iOS 进行后台上传需约 500 MB 可用空间。在 iOS 设置 → 通用 → iPhone 存储中释放空间。iOS 在此场景下不会显示”存储已满”警告，上传只会停滞。

3. 上传队列规模较大

Paper Scanner 顺序处理上传任务。如已积压大量任务（例如离线一段时间后），队列需要时间清空。粗略估计，在普通家庭 Wi-Fi 下约每小时 50 页，信号强时更快，蜂窝网络下更慢。

要判断队列是”慢但有进展”还是”真正卡住”，可将应用置于后台 30 至 60 分钟后再查看状态栏。若数字已增加，说明同步在正常工作；若数字不变，则属于上述其他情形之一。

4. iCloud 账户状态异常

此情况罕见，但可能在 Apple ID 变更、登出登入循环或从备份恢复后出现。症状：状态栏卡死，上述步骤均未能解决。

两个升级步骤：

• 关闭再打开 iCloud 云盘。 iOS 设置 → 你的名字 → iCloud → 关闭 iCloud 云盘，等待 30 秒后再打开。这会强制 iOS 重新协商 iCloud 会话。
• 登出 iCloud 后再登入。 iOS 设置 → 你的名字 → 登出，再重新登录。这会端到端重置 iCloud 连接。该操作重但有效。

若经过两个步骤队列仍停在相同数字，问题很可能在 iCloud 端。Apple 在 support.apple.com 提供系统状态页面，可查询 iCloud 云盘是否存在服务中断。

如何判断是否为 Paper Scanner 端问题

在大多数情况下，原因在 iOS 端。以下情形表明问题可能在 Paper Scanner：

• 状态栏数字超过一小时未变化。
• 同设备其他使用 iCloud 的应用同步正常。
• 已执行上述配置步骤并重启应用。
• 同一批文档在多次启动应用后仍标记为”等待上传”且无进展。

若符合上述条件，请通过应用内的 设置 → 发送反馈 提交 Bug 报告。报告会自动附带最近的同步活动日志，无需用户详细描述问题。

应用内置的卡死应对机制

Paper Scanner 中的几项功能专门针对上传卡死场景：

• 状态栏同时显示当前数量和独立的”最后活动时间”戳，便于即时判断队列是否在推进。
• 若某文档连续三次上传失败，将以警告图标标记，而非继续显示为”上传中”。
• 低电量模式开启时，后台上传会干净地暂停；关闭后自动恢复，不会静默丢弃队列项。

升级至支持团队

若上述步骤未能解决问题，请使用 设置 → 发送反馈 提交报告。所附日志会记录队列状态、iOS 后台状态与网络状况，通常无需进一步沟通即可定位。对于持续性问题，可能会请求 iOS 分析数据（设置 → 隐私 → 分析与改进 → 分析数据）；这是 iOS 自动生成的系统诊断 bundle，包含诊断所需的额外信息。