Alamofire蜂窝网络报Error Domain=NSURLErrorDomain Code=-1009问题解决方法

嘿，这个-1009错误我太熟了，它对应的是NSURLErrorNotConnectedToInternet——系统判定设备当前没有可用网络。但你说WiFi正常、蜂窝网络本身能上网，那大概率是应用的权限或系统配置出了问题，按下面的步骤一步步排查：

1. 先查应用的蜂窝网络权限 #

• 打开iOS系统设置，找到你的应用，进去确认「蜂窝数据」开关是打开的，而且没被限制成仅WiFi可用。
• 有时候系统升级或应用更新后，这个权限会被误关，手动确认最靠谱。

2. 验证ATS（App Transport Security）配置 #

• iOS 9之后默认ATS会阻止非HTTPS的请求，而且蜂窝网络下的限制可能比WiFi更严。如果你的应用用了HTTP接口，这很可能是问题根源。
• 打开项目的Info.plist，检查NSAppTransportSecurity节点：
  • 要是需要允许HTTP请求，要么添加NSAllowsArbitraryLoads并设为YES（注意：提交App Store时需要说明理由），要么更精准地配置NSExceptionDomains，只允许特定域名的HTTP请求。

3. 检查蜂窝网络的代理设置 #

• 有些用户会给蜂窝网手动设置代理，而WiFi下没开，这会导致应用在蜂窝环境下连不上服务器。
• 让用户去设置→蜂窝网络→蜂窝数据选项→代理，确认是「自动」或「关闭」状态，别留着没用的手动代理。

4. 先测系统级的蜂窝连通性 #

• 让用户用Safari在蜂窝网络下直接打开你的应用请求的接口地址，看看能不能正常访问：
  • 如果Safari也打不开，那是用户的蜂窝网络本身有问题（比如运营商限制、信号太差）；
  • 如果Safari能打开，那肯定是应用代码或配置的锅。

5. 排查代码里的网络逻辑 #

• 检查代码里有没有针对WiFi和蜂窝网做差异化处理，比如某些请求只在WiFi下发起，或者蜂窝网络下的超时设置过短（信号弱时容易被误判为无网络）。
• 可以加个网络状态日志，用NWPathMonitor（iOS 12+）或者第三方的Reachability类，打印当前网络类型，确认应用有没有正确识别到蜂窝网络。

6. 终极方案：重置系统网络设置 #

• 如果上面都没用，让用户试试重置网络设置：设置→通用→传输或还原iPhone→还原→还原网络设置。这会清掉所有WiFi密码和蜂窝配置，但有时候能解决系统层面的网络识别bug。

内容的提问来源于stack exchange，提问作者tersintersi