Xcode 26.4 AFNetworking 私有头文件报错处理记录

问题现象

在当前工程执行 Pods 编译时，AFNetworking 4.0.1 出现以下报错：

text 复制代码

/Pods/AFNetworking/AFNetworking/AFNetworkReachabilityManager.m:26:9 Use of private header from outside its module: 'netinet6/in6.h'
/Pods/AFNetworking/AFNetworking/AFHTTPSessionManager.m:32:9 Use of private header from outside its module: 'netinet6/in6.h'

根因分析

AFNetworking 4.0.1 在以下源码中直接引用了私有头文件 #import <netinet6/in6.h>：

Pods/AFNetworking/AFNetworking/AFNetworkReachabilityManager.m
Pods/AFNetworking/AFNetworking/AFHTTPSessionManager.m

新版 Xcode / Clang 会将该引用识别为"模块外私有头文件访问"，从而在编译阶段直接报错。

这里并不需要通过放宽全局编译限制来绕过问题。对应文件实际依赖的 IPv6 结构体和常量可由公开头 #import <netinet/in.h> 提供，因此直接移除 #import <netinet6/in6.h> 即可。

处理方案

为了避免每次 pod install 后手动修改 Pods 目录，本次将修复逻辑固化到 Podfile 的 post_install 阶段。

处理原则如下：

扫描 AFNetworking 目录下所有 .h/.m 文件。
查找 #import <netinet6/in6.h>。
如果存在，则自动删除该导入。
由于 Pods 内目标文件可能是只读权限，写入前临时补充写权限，写入后恢复原权限。

最终 Podfile 补丁

本次在 Podfile 中新增以下逻辑：

ruby 复制代码

def patch_afnetworking_private_header(installer)
  # 扫描并移除 AFNetworking 对私有 IPv6 头文件的直接引用，兼容新版 Xcode 的模块校验。
  afnetworking_dir = File.join(installer.sandbox.pod_dir('AFNetworking'), 'AFNetworking')
  return unless Dir.exist?(afnetworking_dir)

  private_header_import = '#import <netinet6/in6.h>'
  Dir.glob(File.join(afnetworking_dir, '**', '*.{h,m}')).each do |file_path|
    next unless mcs_file_exists(file_path)

    file_content = File.read(file_path)
    next unless file_content.include?(private_header_import)

    original_mode = File.stat(file_path).mode
    File.chmod(original_mode | 0o200, file_path)
    File.write(file_path, file_content.gsub(private_header_import, ''))
    File.chmod(original_mode, file_path)
    puts "patched AFNetworking private header import: #{File.basename(file_path)}"
  end
end

post_install do |installer|
  patch_afnetworking_private_header(installer)

  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '9.0'
      config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
      config.build_settings['CLANG_ENABLE_OBJC_WEAK'] = 'YES'
      config.build_settings['SWIFT_VERSION'] = '5.0'
    end
  end
end

实际修复结果

执行 pod install 后，以下两个文件中的私有头导入已被移除：

Pods/AFNetworking/AFNetworking/AFNetworkReachabilityManager.m
Pods/AFNetworking/AFNetworking/AFHTTPSessionManager.m

修复后的关键导入区如下：

objc 复制代码

#import <netinet/in.h>

#import <arpa/inet.h>
#import <ifaddrs.h>
#import <netdb.h>

验证过程

1. 安装 Pods

执行：

bash 复制代码

pod install

结果：

Pod installation complete!
post_install 补丁正常执行。

2. 检查私有头是否已全部移除

执行：

bash 复制代码

rg -n "netinet6/in6.h" Pods/AFNetworking/AFNetworking

结果：

无输出。
说明 AFNetworking 目录下已不存在该私有头引用。

3. 单独编译 AFNetworking Target

执行：

bash 复制代码

xcodebuild -project Pods/Pods.xcodeproj \
  -scheme AFNetworking \
  -configuration Debug \
  -sdk iphonesimulator \
  -derivedDataPath /tmp/TXLAPP_IOS_Pods_DerivedData \
  CODE_SIGNING_ALLOWED=NO build

结果：

text 复制代码

** BUILD SUCCEEDED **

说明：

AFNetworking 已成功完成真实编译。
AFHTTPSessionManager.m 与 AFNetworkReachabilityManager.m 均已通过编译。
本次处理的私有头报错已被清除。

影响文件

Podfile
Podfile.lock
Pods/Manifest.lock
AIContact.xcodeproj/project.pbxproj
Pods/AFNetworking/AFNetworking/AFNetworkReachabilityManager.m
Pods/AFNetworking/AFNetworking/AFHTTPSessionManager.m

注意事项

这次修复是对第三方库源码的安装阶段补丁，不建议直接长期手改 Pods 文件后不保留 Podfile 逻辑。
后续只要重新执行 pod install，该补丁就会再次自动生效。
当前 Podfile 里仍将 Pods 的 IPHONEOS_DEPLOYMENT_TARGET 设置为 9.0，在新 Xcode 下会出现最低部署版本警告；这不是本次私有头报错的根因，但后续可以单独再整理处理。

结论

本次问题的本质是旧版 AFNetworking 源码中引用了私有系统头文件，导致新编译环境不再允许通过。采用 Podfile post_install 自动移除 netinet6/in6.h 引用的方式，可以稳定修复该问题，并保证后续重新安装 Pods 时无需重复人工处理。