网络层设计

URLSession、拦截器、重试与缓存的组合实践。

概览

一个可靠的网络层需要明确责任边界、可测试性与可观测性。

组件拆分

  • Client:执行请求
  • Router:统一构建 URLRequest
  • Interceptor:日志、鉴权、重试
  • Cache:缓存策略

失败重试

  • 仅对幂等请求重试
  • 采用指数退避
  • 触发条件可配置

关键策略

  • 接口版本与错误码规范
  • 请求与响应结构体分离
  • 对外仅暴露业务层 API