iOS 网络底层深度解析：NSURLSession 原生原理 AFNetworking 封装机制、实战踩坑全解

一、前言为什么你用了多年 AFN依然不懂底层几乎所有 iOS 开发者日常开发百分百依赖 AFNetworking但绝大多数人只会调用GET/POST方法对底层一无所知不知道 AFN 3.x 彻底废弃 NSURLConnection全系基于NSURLSession不清楚 AFN 为什么默认所有请求串行、队列最大并发数4遇到请求超时、重复请求、证书报错、序列化失败只会瞎改参数不懂 AFN 代理转发机制疑惑「为什么 Session 代理是空的还能回调」分不清 NSURLSession 三种 Task 差异下载/上传断点续传原理模糊AFNetworking 不是黑盒魔法它只是对苹果原生NSURLSession的工程级封装封装序列化、异常处理、证书校验、网络监听、线程调度、回调优化。想要彻底解决网络疑难问题、搞定面试网络底层题必须吃透NSURLSession 原生底层 AFN 封装逻辑。本文延续系列博客风格原理拆解 完整流程 大量实战案例 源码核心逻辑 踩坑复盘 面试题从零打通 iOS 网络底层。二、iOS 网络 API 迭代为什么 NSURLSession 取代一切1. 三代网络 API 迭代对比网络API诞生时代核心问题现状NSURLRequest NSURLConnectioniOS2.0无任务管理、无法断点续传、内存泄漏严重、串行阻塞、后台下载鸡肋iOS9 废弃彻底淘汰NSURLSessioniOS7.0无明显短板支持任务管理、断点续传、后台任务、并发控制、缓存优化目前官方主推、AFN 底层核心Network.frameworkiOS13.0基于TCP/UDP底层更灵活适合长连接、自定义协议进阶场景使用常规业务依然用 NSURLSession核心结论AFNetworking 3.0 彻底抛弃 NSURLConnection全系封装 NSURLSession这也是 AFN 稳定、高性能的底层根源。三、NSURLSession 原生底层核心架构必懂NSURLSession 是苹果提供的高性能、异步、可管理网络会话层所有网络请求都基于「会话 任务」模型。1. 三大核心组件1NSURLSession网络会话管理者全局会话载体负责配置全局网络参数、管理所有网络任务、控制并发、缓存、Cookie、协议、超时等。2NSURLSessionConfiguration会话配置类决定 Session 整体行为三种配置模式defaultConfiguration默认配置有内存缓存磁盘缓存Cookie持久化AFN 默认使用ephemeralConfiguration临时会话无磁盘缓存、无Cookie持久化适合隐私请求backgroundConfiguration后台会话支持 App 退后台继续下载/上传3NSURLSessionTask真正的网络任务所有请求都是 TaskSession 只是管理者Task 才是真正发起请求、接收数据的对象。三种 Task 类型覆盖所有业务场景NSURLSessionDataTask普通 GET/POST 接口请求内存接收数据适用于短请求NSURLSessionDownloadTask文件下载自动写入沙盒支持断点续传、后台下载NSURLSessionUploadTask文件/数据流上传支持大文件分片、后台上传2. NSURLSession 原生完整请求流程原生无封装情况下一次网络请求完整步骤创建NSURLSessionConfiguration配置参数基于配置初始化NSURLSession会话创建NSURLRequest请求头、请求方式、超时、参数创建对应 TaskDataTask/DownloadTask/UploadTask手动调用 resume 启动任务重点Task 默认暂停状态通过代理接收数据、进度、完成回调任务结束Session 回收资源3. 原生 NSURLSession GET 实战案例无任何第三方// 1. 创建配置 NSURLSessionConfiguration *config [NSURLSessionConfiguration defaultSessionConfiguration]; config.timeoutIntervalForRequest 15; // 请求超时15s config.HTTPMaximumConnectionsPerHost 4; // 单域名最大并发4 // 2. 创建会话 NSURLSession *session [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil]; // 3. 创建请求 NSURL *url [NSURL URLWithString:https://httpbin.org/get]; NSURLRequest *request [NSURLRequest requestWithURL:url]; // 4. 创建任务并启动 NSURLSessionDataTask *task [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) { if (error) { NSLog(请求失败%,error.localizedDescription); } else { NSDictionary *dict [NSJSONSerialization JSONObjectWithData:data options:0 error:nil]; NSLog(原生请求结果%,dict); } }]; [task resume]; // 必须手动resume任务才会执行核心痛点原生写法繁琐、无自动序列化、无统一异常处理、无进度回调、无证书适配、难以批量管理任务这就是 AFN 存在的意义。四、AFNetworking 整体架构与五大核心模块AFN 不是简单封装是一套高内聚、低耦合的五层架构每个模块职责单一这也是 AFN 长期稳定的核心原因。1. AFN 五大核心模块网络通信模块核心AFURLSessionManager、AFHTTPSessionManager封装 NSURLSession 所有能力管理任务、代理、并发序列化模块AFHTTPRequestSerializer/AFHTTPResponseSerializer自动处理 JSON/表单/二进制参数与响应解析安全策略模块AFSecurityPolicy封装 TLS 证书校验、SSL 双向认证、防中间人攻击网络状态模块AFNetworkReachabilityManager实时监听 2G/3G/4G/WiFi/无网状态UIKit 扩展模块图片异步加载、网络状态 HUD、进度条等业务扩展能力2. 核心类继承关系面试高频AFHTTPSessionManager → 继承 AFURLSessionManager → 封装 NSURLSession很多人混淆两个 ManagerAFURLSessionManager底层基础类通用网络会话不局限 HTTP可自定义协议AFHTTPSessionManager业务上层类专门适配 HTTP/HTTPS内置 GET/POST/PUT/DELETE 快捷方法日常开发99%用它五、AFNetworking 底层完整请求链路源码级拆解以最常用的AFHTTPSessionManager GET请求为例拆解从调用到响应的全底层流程。Step1初始化 Manager全局唯一 SessionAFN 初始化 Manager 时会全局创建一个 NSURLSession所有请求共享同一个 Session避免重复创建会话造成性能损耗。同时初始化请求序列化器、响应序列化器、安全策略、并发配置。Step2参数序列化生成 NSURLRequestAFN 自动通过AFHTTPRequestSerializer完成URL 拼接参数GETBody 拼接 JSON/表单参数POST自动设置请求头 Content-Type、User-Agent统一超时时间、缓存策略Step3创建 DataTask绑定代理 Delegate这是 AFN 最精妙的设计任务级代理转发原生 NSURLSession 所有任务共用 Session 代理无法区分不同任务回调AFN 为每一个 Task 单独绑定一个 AFURLSessionManagerTaskDelegate实现不同请求互不干扰回调精准进度回调、成功失败回调任务结束自动销毁代理杜绝内存泄漏Step4加入任务队列控制并发AFN 默认队列最大并发数为4同一时间最多4个网络任务并行其余任务排队串行执行防止瞬间大量请求抢占线程、造成卡顿、超时。Step5resume 启动任务底层走 NSURLSession 网络链路最终依然调用原生[task resume]底层经过DNS解析 → TCP握手 → TLS握手 → 加密传输 → 接收数据。Step6数据接收、自动反序列化收到服务端数据后AFN 通过AFHTTPResponseSerializer自动校验响应状态码200~299 成功其余自动判定失败自动 JSON 解析、数据转模型捕获解析异常统一回调错误信息Step7主线程回调结果网络任务默认子线程执行AFN 内部自动切回主线程回调 Block开发者无需手动刷新UI线程避免线程错乱崩溃。六、高频实战案例AFN 常用场景代码落地案例1基础 GET/POST 请求标准封装// 初始化全局管理者 AFHTTPSessionManager *manager [AFHTTPSessionManager manager]; manager.responseSerializer.acceptableContentTypes [NSSet setWithObjects:application/json,text/plain,text/html, nil]; manager.requestSerializer.timeoutInterval 15; // GET 请求 [manager GET:https://httpbin.org/get parameters:{name:test} progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) { NSLog(GET成功%,responseObject); } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) { NSLog(GET失败%,error); }]; // POST 请求 [manager POST:https://httpbin.org/post parameters:{age:18} progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) { NSLog(POST成功%,responseObject); } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) { NSLog(POST失败%,error); }];案例2文件上传带进度回调AFHTTPSessionManager *manager [AFHTTPSessionManager manager]; [manager POST:https://httpbin.org/post parameters:nil constructingBodyWithBlock:^(idAFMultipartFormData _Nonnull formData) { // 拼接上传文件 UIImage *image [UIImage imageNamed:test]; NSData *imageData UIImagePNGRepresentation(image); [formData appendPartWithFileData:imageData name:file fileName:test.png mimeType:image/png]; } progress:^(NSProgress * _Nonnull uploadProgress) { // 子线程回调上传进度 CGFloat progress 1.0 * uploadProgress.completedUnitCount / uploadProgress.totalUnitCount; NSLog(上传进度%.2f,progress); } success:^(NSURLSessionDataTask * _Nonnull task, id _Nullable responseObject) { NSLog(上传成功); } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) { NSLog(上传失败%,error); }];案例3文件下载 断点续传AFN 基于 DownloadTask 天然支持断点续传暂停后再次请求可接续下载无需自己处理数据偏移。案例4自定义请求头、Token 全局配置AFHTTPSessionManager *manager [AFHTTPSessionManager manager]; [manager.requestSerializer setValue:Bearer xxxxxxxx forHTTPHeaderField:Authorization]; [manager.requestSerializer setValue:iOS forHTTPHeaderField:Client-Type];案例5HTTPS 证书配置兼容上篇 HTTPS 原理AFHTTPSessionManager *manager [AFHTTPSessionManager manager]; // 开发环境允许非法证书线上禁止 manager.securityPolicy.allowInvalidCertificates YES; manager.securityPolicy.validatesDomainName NO;七、核心底层重难点解析解决90%疑难问题1. 为什么 AFN 不会内存泄漏很多人疑惑 Block 回调为什么不循环引用AFN 的 TaskDelegate 是临时绑定、任务结束立即销毁Block 内部弱引用回调任务完成后自动置空Session 全局唯一生命周期跟随 App不存在泄漏风险2. AFN 并发数为什么默认是4源于系统原生限制HTTPMaximumConnectionsPerHost单域名最大并发连接数系统默认6AFN 优化为4平衡速度与稳定性防止并发过高导致服务器限流、请求超时、链路抢占。3. 请求超时原理AFN 设置的timeoutInterval本质是 NSURLRequest 的超时时间从请求发起开始15s 未完成数据传输直接判定超时。注意网络阻塞、DNS 解析慢、服务器卡顿都会触发超时。4. 为什么后台下载必须用 Background 配置default 配置的 Session 在 App 退后台后会被系统挂起任务暂停background 配置可让系统托管任务后台持续执行上传下载。八、高频踩坑案例复盘实战必看坑点1请求超时、偶发请求失败原因多个页面共用同一个 Manager并发队列拥堵、请求排队超时全局超时时间过短。解决核心长接口单独创建 Manager适当调大超时时间控制并发数。坑点2响应数据解析失败JSON 乱码/格式错误原因AFN 默认只接收 JSON 格式部分接口返回 text/html、text/plain触发解析失败。解决手动添加可接收内容类型manager.responseSerializer.acceptableContentTypes [NSSet setWithObjects:application/json,text/html,text/plain,charsetutf-8, nil];坑点3重复请求导致数据错乱原因快速点击多次触发请求多个 Task 同时执行后返回的数据覆盖前数据。解决页面消失/请求新任务时取消上一次 Task[task cancel]。坑点4HTTPS 真机报错、模拟器正常原因真机严格证书校验模拟器默认信任非法证书与上篇 HTTPS 证书校验逻辑一致。坑点5上传大文件进度不动、卡顿原因文件数据一次性加载进内存造成内存暴涨、主线程阻塞。解决使用文件路径上传而非二进制 Data 上传避免内存峰值过高。九、面试高频必背问答百分百命中1. AFNetworking 底层基于什么实现为什么废弃 NSURLConnectionAFN3.0 全系基于NSURLSession原生封装NSURLConnection 老旧、不支持断点续传、后台任务、并发管理差、内存问题多iOS9 已废弃NSURLSession 性能与功能全面碾压。2. AFHTTPSessionManager 和 AFURLSessionManager 区别AFURLSessionManager底层通用基础类封装 NSURLSession 核心能力适配所有网络协议AFHTTPSessionManager继承自前者专门适配 HTTP/HTTPS封装常用 GET/POST 快捷方法业务开发首选。3. AFN 如何实现多任务回调隔离通过任务级代理绑定为每一个 NSURLSessionTask 单独创建 TaskDelegate替代原生 Session 全局代理实现不同任务回调互不干扰。4. AFN 默认并发数是多少为什么默认最大并发 4基于系统单域名连接限制兼顾请求速度与服务器压力避免高并发导致请求拥堵、超时、限流。5. AFN Block 回调为什么不会内存泄漏AFN 采用临时任务代理模式任务生命周期短Block 无循环引用任务结束后代理立即销毁无内存堆积。6. NSURLSession 的三种 Task 区别DataTask短请求接口内存接收数据DownloadTask文件下载沙盒存储、支持断点续传、后台下载UploadTask文件上传适配大文件、后台上传。7. AFN 请求默认是串行还是并行默认最大4并行超出排队串行并非完全串行也不是无限并行。十、全文总结1.底层本质AFNetworking 是 NSURLSession 的工程级封装无私有黑能力所有网络能力均来自苹果原生 API。2.核心优势统一序列化、统一异常处理、任务隔离、并发控制、线程自动切换、证书安全封装、网络状态监听极大简化原生复杂写法。3.核心流程共享Session → 参数序列化 → 绑定任务代理 → 队列调度 → 原生Task执行 → 自动解析 → 主线程回调。