开启 3 天免费试用
注册即可免费体验全部高级功能。
*仅限新用户；每位用户只能获得一次试用。
AzCopy 上传中断：如何用作业日志定位错误并安全恢复？
Marcus Reid
2026年10月7日· 8 分钟阅读
AzCopy 上传中断后，先保存作业 ID、计划文件和日志，再考虑重新复制。读取首个失败传输，区分身份验证、存储访问与网络超时；只有目标和剩余操作都经过核对的任务，才进入恢复步骤。
关键要点：
- 保留作业计划和源文件，重建任务不等于恢复。
- 403 先查凭据与存储策略，不重复换路径。
- 最终状态要与 failed、skipped 计数一起看。
- 实际传输后核验对象，SAS 始终私下保留。
步骤 1：AzCopy 上传中断发生在哪个执行环境？
确认真正运行 AzCopy 的电脑或服务，记录版本、操作系统、作业 ID、源端与目标端角色。分清本地上传、下载，还是服务之间复制；从笔记本发起任务，不代表全部数据经过笔记本或本机 VPN。
原始命令私下保存并保护秘密。分享前去除 SAS 查询值、敏感账户标识、私密路径及授权信息。保留原文件和目标当前状态，不理解任务前不先删除部分结果。
AzCopy 生成日志和作业计划，官方文档说明如何按 ID 查看和恢复。［1］ 日志记录事件，计划记录创建任务时发现的待处理对象；丢失计划可能让原有恢复流程失去依据，即使源文件仍存在。
多个客户端同时异常时，先按设备与应用连接基线检查。实际工具不同，则另行诊断 rclone 重试模型，不把它的参数和假设套入 AzCopy。
步骤 2：日志与传输计数究竟说明什么？
先读已有作业日志，不为生成诊断而再跑完整传输。定位与失败操作对应的首个相关错误，记下时间和请求方法。Microsoft 排障指南区分连接、身份验证和存储错误，最终摘要未必能说明根因。［2］
将下方占位符换成已保存的作业 ID，在本地执行：
azcopy --version
azcopy jobs list
azcopy jobs show YOUR-JOB-ID
azcopy jobs show YOUR-JOB-ID --with-status=Failed
文档中的 --with-status 值区分大小写。［1］ 错误筛选值或作业 ID 可能让你看不到真正要查的工作。把摘要与失败筛选结果一起保留，不能只凭一条空输出认定没有失败。
记录 total、completed、failed、skipped、实际字节及检查的目标。作业显示完成，仍可能与预期不同，例如原命令排除了部分文件，或跳过已有对象。状态描述的是该任务，不能代替整个预期数据集合的核验。
步骤 3：属于访问失败还是 AzCopy 网络超时？
结合账户、端点、操作和时间解读错误。403 可能来自不同授权或存储策略条件；不把所有 403 都解释为 SAS 过期，也不认为它意味着换另一个公网出口就获准访问。
| 证据 | 责任分支 | 安全的下一项检查 |
|---|---|---|
| 403 或身份验证被拒 | 凭据、权限、存储策略 | Token 范围、有效期、访问条件 |
| 连接或读取超时 | 路径、代理、端点、服务中断 | 具体操作、时间、执行设备 |
| 限流或服务错误 | 存储服务与重试策略 | 提供方说明和事故证据 |
| 源文件不能读取 | 本地路径或源端访问 | 已保留源文件和权限 |
| 传输被跳过 | 已有对象或选择规则 | 原任务意图与目标 |
| 要求私有端点 | 组织网络 | 获准私有连接与 DNS 负责人 |
按正常安全流程核对凭据有效窗口，以及该操作需要的权限。不把完整 SAS 粘到在线解码器、论坛或截图；即使即将过期，仍需保护。
存储防火墙或 IP 限制由管理员确认允许哪条路径。消费 VPN 可能产生明确不被允许的公网地址。保留 TLS 验证；证书错误应调查信任配置或拦截，不通过关闭安全检查换取成功摘要。
步骤 4：这个作业本身可以安全恢复吗？
选择 AzCopy 恢复作业前，确认源端仍代表预期数据，目标仍是获准测试位置。检查计划文件是否在配置的位置，不把移动、重命名或清理计划当成首个排障动作。
恢复按原计划重试此前未传完的工作。出于安全原因，SAS 不保存在计划中，因此 SAS 任务可能需要私下重新提供相关源端或目标端的当前有效令牌。［1］ 这是同一授权范围内更新凭据，不意味着可扩大目标或账户范围。
azcopy jobs resume YOUR-JOB-ID
只有原任务身份验证要求已满足时，上述基本形式才足够。若需 SAS，按官方命令说明，仅私下提供需要的那一端令牌。不在文章示例中填真实值，也不声称每个上传都需要同时传源端和目标端 SAS。
还有大量剩余写入的生产作业，不是无害连接测试。请所有者批准恢复，或先定义独立、范围受控的测试任务。原计划缺失或无法确认目标时停止，与所有者重建获准操作，不猜测哪些文件尚未传输。
步骤 5：如何把路径比较限制在一项测试？
准备无敏感信息的本地文件和测试容器中的获准空目标。启动前核对两端，比较时保留相同 AzCopy 版本、身份验证范围、文件、作业设置和存储端点。否则无法单独判断路径变化。
失败测试作业可恢复时，第二次继续保留该 ID 和计划。不要因为一次超时，便对同一生产路径重开大型递归复制。明确的窄范围恢复，比结果未知且相互重叠的任务更有诊断价值。
确认进程从 shell 或计划任务继承的配置。Windows 可查看系统代理上下文，再确认进程实际采用的获准网络设置。桌面浏览器使用另一连接，不能代表这条命令的路径。
换路前记下初始计数和目标状态。第二次可能仅剩更少工作，因为第一轮已发送部分对象；应描述为恢复证据，不宣称公平的速度比较。如果没有剩余数据需要传输，resume 成功也不能验证新路径上的上传流量。
步骤 6：剩余公网传输能否通过另一条获准路径完成？
只有 timeout 或连接分支，且获准使用替代公网路径时才继续。私有端点、强制代理和出站 IP 限制仍由存储所有者控制。如果已有 VPN 可能造成故障，先比较获准直连，不强行推荐另一服务。
在保存可恢复 AzCopy 测试作业的 Windows 电脑上，AethoVPN 可提供出站对照：使用官方安装包及桌面 Pro 或 Premium，选择当前可用的就近位置，恢复前开启全局模式。保持计划与资源范围不变，再核对剩余传输和目标对象；403、过期 SAS、存储防火墙规则或私有端点要求仍须分别处理。用邮箱注册，开始 3 天免费 Pro 试用以核验作业恢复；每人仅一次，试用从注册时开始。
Debian/Ubuntu x64 在实际执行 AzCopy 的机器使用官方 .deb。Mac 按官网设置向导在 VPN 客户端中连接，需 Pro 或 Premium。不描述原生 Mac App，也不声称本机客户端会改变云端 worker 的路线。
resume 前核验 VPN 连接。记录两次尝试，路径未经许可或再次返回访问错误时停止；一次恢复不保证后续可用，也不改变存储所有者的责任。
步骤 7：目标核验和测试清理完成了吗？
重新查看统计和剩余 failed。逐项解释 skipped：对象原本正确、被任务排除，还是实际上没有传输？即使零失败，也应与预期测试对象、大小和内容对照。
通过获准方法把无敏感信息对象读回另一个核验位置。服务与流程提供适用完整性元数据时也检查它。不假设所有上传都会自动保存内容哈希，也不把看到文件名当作预期字节已到达。
保留简明记录：作业 ID、端点角色、脱敏命令、首个错误、源文件状态、前后计数、实际传输及目标核验。区分观察与未测试条件，尤其服务端复制和私有访问路径。
恢复临时诊断设置，再由所有者决定生产作业何时重启。保留证据后只移除批准的测试对象；不大范围清理容器或删除影响其它恢复的计划。持续失败交管理员或官方支持，提供检查过的片段，不公开令牌。
总结
- 保存作业 ID、计划、日志和原始源文件。
- 修改凭据或路径前先分类首个错误。
- 只恢复核对过的工作，记录实际传输。
- 对照目标内容及完成、失败、跳过计数。
常见问题
新开复制与恢复作业有什么区别？
恢复使用原计划和剩余工作，新调用会发现一项新任务，并可能与既有目标重叠。应先核对写入范围，不把两者当成等价重试。［1］
每个 403 都表示 SAS 已过期吗？
403 也可能来自权限或存储访问策略。检查具体操作和获准范围；未确定责任分支前，不随意更新令牌或反复切换路径。
删除计划文件后能否恢复？
官方恢复依赖作业计划，应在清理前保留。计划不可用时，请任务所有者定义新的获准恢复，而不是猜测哪些文件还没发送。
为什么恢复成功却没有发送字节？
可能没有剩余符合条件的工作，或对象被跳过。该结果能描述任务状态，但不能证明刚切换的路径真正传输了上传数据。
求助时是否应提供完整 SAS？
只通过获准支持渠道发送脱敏命令及已审阅的错误片段。日志和完整 URL 可能含敏感信息，即使令牌有效期短也不应公开。
本机 VPN 能否处理私有存储端点？
私有端点依赖组织批准的网络和命名配置。另一个公网出口不是私有连接，还可能违反存储防火墙或出站 IP 策略。
何时可以恢复生产任务？
先确认预期对象、实际传输计数和已修正原因，再由所有者单独批准生产范围。小测试恢复成功，不等于整项迁移或备份通过核验。
免责声明： 仅恢复获准作业并保护原数据。不绕过存储访问控制、不暴露凭据，也不关闭证书验证来取得成功摘要。
来源
- Microsoft — Find errors and resume jobs with logs in AzCopy — https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-configure
- Microsoft — Troubleshoot issues in AzCopy — https://learn.microsoft.com/en-us/troubleshoot/azure/azure-storage/blobs/connectivity/storage-use-azcopy-troubleshoot
Sources checked 2026 年 10 月 7 日。
