排查 iCloud 上传卡住

排查 iCloud 上传卡住

当 Paper Scan 中的 iCloud 同步看起来卡住时(通常显示为几分钟不变化的部分上传计数),原因几乎总是 iOS 侧四种配置或系统状况之一。以下清单按频率顺序列出它们,以及每种的验证步骤。

1. 未为 Paper Scan 启用 iCloud Drive

两个独立的开关必须打开。任一关闭都会导致 Paper Scan 将上传排队,但被 iOS 静默拒绝,使状态栏固定在初始计数。

• iOS 设置 → [你的名字] → iCloud → 显示全部 → Paper Scan 必须打开。
• iOS 设置 → Paper Scan → iCloud Drive 必须打开。

第二个开关是最常被遗漏的。两个设置相关但不同;两者都必须启用才能上传继续。

2. iOS 正在限制后台同步

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

• 开启了低电量模式。 在 iOS 设置 → 电池中将其关闭。低电量模式下,iOS 会延迟或暂停后台上传以节省电量。
• iPhone 存储几乎已满。 iOS 需要大约 500 MB 的可用空间才能继续后台上传。在 iOS 设置 → 通用 → iPhone 存储中释放空间。iOS 在这种情况下不会显示「存储已满」警告;上传只是卡住。

3. 上传队列很大

Paper Scan 按顺序处理上传。如果已累积大量积压(例如离线一段时间后),队列需要时间清除。作为粗略估计,在标准家庭 Wi-Fi 上预计每小时约 50 页,在强连接上更快,在蜂窝网络上更慢。

要确定队列是"缓慢但在推进"还是"真正卡住",将应用置于后台 30 到 60 分钟,然后检查状态栏。如果计数已前进,说明同步正常工作。如果计数未变,则适用其他条件之一。

4. iCloud 账户状态已损坏

这很少见,但可能发生在 Apple ID 更改、退出登录和登录循环,或从备份恢复之后。症状:状态栏卡住且以上步骤均未解决。

两个升级步骤:

• 关闭并重新打开 iCloud Drive。 iOS 设置 → [你的名字] → iCloud → 关闭 iCloud Drive,等待 30 秒,重新打开。这会强制 iOS 重新协商 iCloud 会话。
• 退出 iCloud 并重新登录。 iOS 设置 → [你的名字] → 登出,然后再次登录。这会重置整个 iCloud 连接。此操作虽然激进但有效。

如果两个步骤后队列仍卡在同一计数,问题可能在 iCloud 端。Apple 在 support.apple.com 的系统状态页面显示 iCloud Drive 当前是否正在经历中断。

如何确定问题是否在 Paper Scan 端

在大多数情况下,原因在 iOS 侧。在以下情况,Paper Scan 可能出错:

• 状态栏计数在一小时内没有变化。
• 同一设备上其他使用 iCloud 的应用正常同步。
• 已应用上述配置步骤并已重启应用。
• 相同文档在多次应用启动中被标记为待上传但没有任何进展。

当这些条件适用时,请通过应用中的 设置 → 发送反馈 提交错误报告。该报告会自动包含最近的同步活动日志,无需用户详细描述问题。

应用中包含的解决方案

Paper Scan 中的几个功能专门用于应对上传卡住的情况:

• 状态栏同时显示当前计数和单独的最后活动时间戳,可立即评估队列是否在推进。
• 如果某个文档连续三次上传失败,它会被标记为警告图标,而不是继续显示为"上传中"。
• 后台上传在启用低电量模式时干净地暂停,在禁用时恢复,而不是静默丢弃队列项目。

升级到支持

当上述步骤未解决问题时,请使用 设置 → 发送反馈 提交报告。包含的日志会捕获队列状态、iOS 后台状态和网络条件,通常无需进一步通信即可诊断。对于持续性问题,可能需要 iOS 分析数据包(设置 → 隐私 → 分析与改进 → 分析数据);这是由 iOS 自动生成的系统诊断包,包含对诊断有用的其他信息。