SaaS 文件上传如何测试？检查跨地区网络下的续传与文件完整性 | 全球代理

文件上传是否可靠，不能只看最后有没有上传成功。如出现连接中断或 TLS 错误，可参考连接超时、TLS 握手和代理出口稳定性记录。要固定文件大小、类型、带宽和丢包，分别记录上传耗时、暂停后续传、校验和比对、失败后的临时文件清理；四项里任何一项不稳定，跨地区的体验都会明显变差。同一组测试里，出口带宽和代理类型要保持一致。接下来分别检查耗时、续传、完整性和失败清理，并为每项记录通过标准。

定义测试文件、网络条件和上传指标

测试文件要写死三件事：大小、类型、内容。大小至少覆盖三档：1 MB 以内、中档（约为上限的 10%–50%）、接近上限（产品配置上限的 90%–100%，按授权测试环境容量调整）；只有产品上限约为 1 GB 时，第三档才是 1 GB 左右；类型覆盖图片、PDF、压缩包和纯文本；内容用可生成随机数据的合成文件，避免用真实客户文档。

网络条件也要写死：带宽、延迟、丢包率。发现异常后先区分网络波动与产品缺陷：换出口、换时段各复测一次，再看失败是否跟着文件或接口走。跨地区测试常见的错误是只换出口不控网络，结果测到的是网络质量，不是产品行为。目标地区可参考全球代理 IP 产品页选择；出口自身的可用率与延迟，可单独参照代理 IP 可用率、延迟和稳定性测试记录。出口带宽与类型同样要固定，混用会让耗时不可比。

比较不同地区的上传耗时和成功率

耗时按分位数记录，不记平均值。平均值会掩盖长尾，而上传体验恰恰由长尾决定：10 次里 9 次 20 秒、1 次 3 分钟，用户感受到的是 3 分钟。

成功率要预先按项目目标定义：成功怎么算、重试是否计入、同一文件重复多少次。10 次只作冒烟样例，不能把固定失败次数或 90% 这类脱离业务的口径当成通用验收标准。小样本下的分位数只能作探索观察，报告里必须同时列出样本量和原始耗时，否则 P95 在 10 次样本上没有统计意义。实际判定以下表“通过标准”一栏的项目阈值和团队约定为准。失败要记录失败阶段：是连接建立失败、中断在 90%、还是服务端返回 5xx，三者对应完全不同的修法。

验证网络中断后的断点续传

续传要测三种中断：主动暂停、网络中断、页面刷新。但只有产品声明支持的恢复方式才能作为通过断言：主动暂停和断网通常要求服务端保留分片或偏移记录；页面刷新续传还额外要求上传会话能跨刷新持久化。产品没有这项能力时，把对应场景记为“不支持”，不要记为“失败”。

判定续传是否真的生效，看的不是界面提示，也不是总传输量。抓一次网络记录，同时核对服务端的分片或偏移记录：恢复后只传剩余部分才算生效。存在协议重发开销时总量可能略大于文件大小，开启压缩时又可能小于文件大小，所以不能只凭“总量等于文件大小”就判成伪续传。

用校验和确认文件完整性

上传完成后比对源文件与服务端文件的校验和（MD5 或 SHA-256）。跨地区链路出现静默损坏的概率不高，但一旦发生，用户拿到的是打不开的文件，比上传失败更难排查。

校验要在服务端做，不要只在前端算。前端算完传到服务端、服务端再算一遍，两者一致才算通过。

检查失败清理和重试去重

失败清理和去重是两件事：一个看临时数据有没有被及时收走，一个看重试有没有生成两份业务记录。可执行用例按这个顺序走：

1. 记录本次上传的 upload / session ID，作为后续核对的主键。
2. 在分片上传中途强制断网，或主动取消，模拟真实中断。
3. 在产品规定的保留期内重连，确认已完成分片仍在、可以续传——这是“中断就立刻清理”最容易踩的坑。
4. 超过清理窗口或主动终止后，再查临时分片、临时对象和上传任务的状态是否被清掉。
5. 用同一份文件重试上传，确认最终只生成一份业务记录，没有重复行、重复计费或两份存储对象。

表格里要写清清理的触发条件（超时、取消、失败次数）和允许保留期，否则“清理了”和“该清理的没清理”都无从判断。重试策略也要有上限：无限重试在弱网下会放大流量，还可能触发服务端限流。

> 表格中的阈值、用例编号和结果如无测试记录支持，均应视为演示样例；实际验收标准以项目需求、历史基线或团队约定为准。

FAQ

测上传需要专门用住宅 IP 吗？

不一定。模拟用户体验可使用符合测试目标的住宅出口并控制带宽，测服务端上限则应隔离网络变量。代码接入需设置代理时，按所用语言与代理网关的接口文档配置主机、端口、账号和密码。

小文件和大文件的指标差很多，正常吗？

正常。分档记录，不要跨档比较 P95。

上传成功但用户打不开，算哪类问题？

先查校验和与存储路径，再核对响应码和服务端日志；问题定位为连接层时，可参考连接超时、TLS 握手和代理出口稳定性记录。

移动端弱网要单独测吗？

要。4G/5G 切换会中断连接，续传用例必须覆盖。