iOS URLSession 请求与数据流处理

摘要：URLSession 支持数据请求、上传、下载和后台传输。本文介绍请求构造、响应验证、并发取消、数据解码和错误分类的组织方式。

一、集中构造请求

为请求设置明确的方法、地址、请求头和超时。参数应使用结构化编码，避免手动拼接查询字符串或在多个界面重复复制认证信息。

请求层应接受可替换的 URLSession 或传输协议，使测试可以注入确定性响应。业务代码不应依赖全局会话配置。

二、验证 HTTP 响应

收到数据不等于请求成功。客户端需要检查响应类型和状态码，再决定是否解码业务数据。服务端返回的错误体可能包含稳定错误码，但用户展示不应直接暴露内部信息。

空响应、无内容状态和结构变化要有明确处理。不能把解码失败转换成空模型，否则协议变化会变成难以发现的界面问题。

三、处理取消与并发

使用 async/await 的异步接口可以将任务取消传递到数据请求。页面离开或查询变化时取消旧请求，并在恢复结果后确认状态仍对应当前查询。

多个互不依赖的请求可以并行，依赖前置结果的任务则应顺序执行。并发请求数量过多时需要限流，避免占用连接和电量。

四、下载大文件

大型文件应使用下载任务，将响应写入临时文件，而不是完整载入内存。下载完成后先验证文件类型和大小，再移动到正式存储位置。

中断后是否支持续传取决于服务端能力。临时文件应在取消或失败时根据恢复策略保留或清理。

五、设计错误类型

将错误区分为连接失败、超时、服务器错误、鉴权失效、解码失败和任务取消。上层根据错误类型选择重试、重新登录或提示用户。取消通常不应呈现为失败。

日志可以记录请求阶段、耗时和状态码，但要过滤令牌、个人信息和敏感查询参数。

六、测试网络代码

通过可控传输层返回成功、错误、空响应和格式异常，验证解析逻辑。异步测试不要依赖实际网络和固定等待时间。还应验证取消后旧响应不会覆盖新状态。

七、总结

URLSession 的可靠用法依赖集中请求构造、显式响应验证、可传播的取消和稳定错误分类。大文件采用流式落盘，测试使用确定性传输层，可以减少内存压力和网络不确定性。