iOS/macOS: The certificate for this server is invalid(NSURLSession 报错)
问题背景与根因:-1202 不是网络问题,而是信任链校验失败
iOS/macOS 上的 NSURLSession 走的是系统原生 Security.framework 与 CFNetwork 网络栈,证书校验失败时不会像 Safari/Chrome 那样给出「继续访问」的选项,而是直接抛错。典型日志如下:
Error Domain=NSURLErrorDomain Code=-1202
"The certificate for this server is invalid. You might be connecting to a server
that is pretending to be “api.example.com”, which could put your confidential
information at risk."
UserInfo={NSURLErrorFailingURLStringErrorKey=https://api.example.com/v1/login,
_kCFStreamErrorCodeKey=-9807,
NSUnderlyingError=0x... {Error Domain=kCFErrorDomainCFNetwork Code=-1202}}
常见错误码与含义:-1200 NSURLErrorSecureConnectionFailed(TLS 握手失败)、-1201 NSURLErrorServerCertificateHasBadDate(过期或未生效)、-1202 NSURLErrorServerCertificateUntrusted(信任链构建失败)、-1203 NSURLErrorServerCertificateHasUnknownRoot(根 CA 不受信任)、-1204 NSURLErrorServerCertificateNotYetValid(尚未生效)、-1205 NSURLErrorClientCertificateRejected(mTLS 客户端证书被拒)。
根因可归为四类:
- 证书本身不合规:过期、SAN 缺少请求域名、RSA 1024 弱密钥、SHA-1 签名。
- 证书链不完整:服务端只下发叶子证书,缺少中间证书。iOS 不会像桌面浏览器那样可靠地做 AIA 补链,这是 -1202 最高频的原因。
- 不满足 ATS:App Transport Security 自 iOS 9 起默认要求 TLS 1.2+、SHA-256 签名与前向保密套件(ECDHE)。
- 有效期超限:Apple 对 2020-09-01 之后签发的 TLS 服务器证书强制 398 天上限(此前的旧证书为 825 天),超限直接判定不受信任。
注意:ATS 是「默认拒绝」策略,Info.plist 里的 NSAllowsArbitraryLoads 只是兜底开关,不能当作修复手段。
第一步:用 openssl 快速定位证书与链的问题
在 macOS 本机或服务器上执行以下命令,可在 1 分钟内判断问题出在链、算法还是协议版本。务必带 -servername,否则 SNI 不发送,可能拿到默认站点证书而误判为主机名不匹配。
# 1) 查看服务端实际下发的叶子证书
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2) 检查签名算法与公钥强度(SHA-1、RSA 1024 都是高危)
openssl s_client -connect api.example.com:443 -servername api.example.com </dev/null 2>/dev/null
| openssl x509 -noout -text | grep -E "Signature Algorithm|Public-Key"
# 3) 统计链上证书数量,正常应为 2~3 张
openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null 2>/dev/null
| grep -c "BEGIN CERTIFICATE"
# 4) 用系统根库验证链
openssl s_client -connect api.example.com:443 -servername api.example.com -verify_return_error </dev/null
# 期望:Verify return code: 0 (ok)
判读要点:
Verify return code: 21 (unable to verify the first certificate)→ 缺中间证书,最常见。Verify return code: 20 (unable to get local issuer certificate)→ 根 CA 不在本地信任库,或链断裂。Verify return code: 10 (certificate has expired)→ 证书已过期。Signature Algorithm: sha1WithRSAEncryption→ 必须换 SHA-256。Public-Key: (1024 bit)→ 必须 ≥ 2048 位。
再确认 TLS 版本支持:
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_1 </dev/null
# 期望:handshake failure(服务端应已禁用 TLS 1.0/1.1)
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null
# 期望:Verify return code: 0 (ok)
macOS 上还可用 security find-certificate -a -p /System/Library/Keychains/SystemRootCertificates.keychain | grep -c "BEGIN CERTIFICATE" 确认系统根证书库数量,判断私有 CA 是否缺失。
第二步:服务端修复——Nginx 配置 TLS 1.2+、SHA-256 与完整链
把 ssl_certificate 指向「叶子 + 中间」拼接的 fullchain,是解决 -1202 最关键的一步。Nginx 示例:
server {
listen 443 ssl;
http2 on; # nginx ≥ 1.25.1;旧版用 listen 443 ssl http2;
server_name api.example.com;
ssl_certificate /etc/nginx/ssl/api.example.com.fullchain.pem; # 叶子+中间,顺序不能反
ssl_certificate_key /etc/nginx/ssl/api.example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_ecdh_curve X25519:secp256r1;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/api.example.com.chain.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}
Apache 2.4 对应配置:
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
SSLCertificateFile /etc/httpd/ssl/api.example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/api.example.com.key
三个要点:
- 证书必须由公共 CA 签发且带完整链;自签名证书只适合内网,需配合 MDM 预置根 CA 或 App 内 Pinning。
- 禁用 TLS 1.0/1.1 与所有非 ECDHE 套件,满足 ATS 的 NSExceptionRequiresForwardSecrecy 默认值。
- 改完执行
nginx -t && nginx -s reload,再回到第一步复测Verify return code。
第三步:拼接与校验 fullchain(含 verify 命令)
CA 通常下发三个文件:叶子证书 cert.pem、中间证书 intermediate.pem、根证书 root.pem。拼接顺序必须是叶子在前、中间在后,根证书一般不放(放了也不会报错,但会增加握手体积)。
# 拼接 fullchain
cat cert.pem intermediate.pem > fullchain.pem
# 本地验证链(root.pem 提供信任锚,intermediate.pem 提供中间证书)
openssl verify -CAfile root.pem -untrusted intermediate.pem cert.pem
# 期望:cert.pem: OK
# macOS 上用系统根库验证
openssl verify -CAfile /etc/ssl/cert.pem fullchain.pem
# 期望:fullchain.pem: OK
检查是否满足 Apple 的 398 天有效期要求:
openssl x509 -in cert.pem -noout -dates
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=Apr 3 23:59:59 2026 GMT ← 间隔必须 ≤ 398 天
openssl x509 -in cert.pem -noout -checkend $((398*86400))
# 输出 "Certificate will expire" 表示剩余有效期已不足 398 天,属正常现象
再确认证书是否带 CT(Certificate Transparency)SCT 扩展——Apple 要求 2018-10-15 之后签发的证书必须提交到 CT 日志:
openssl x509 -in cert.pem -noout -text | grep -A2 "CT Precertificate SCTs"
# 无输出说明证书不带 SCT,需要向 CA 重新签发(Let's Encrypt 默认已带)
顺带确认 Let’s Encrypt 证书的 90 天有效期属正常,不要误判为「过期配置」;真正要卡的是 398 天上限。
第四步:ATS 兼容性诊断与 Info.plist 例外配置
macOS 自带 nscurl,可逐项模拟 ATS 的各项要求:
# 完整诊断
nscurl --ats-diagnostics --verbose https://api.example.com
# 只看结论
nscurl --ats-diagnostics https://api.example.com | grep -E "ATS Default Connection|Result"
典型输出(服务端不合规时):
ATS Default Connection
Result : FAIL
...
ATS with TLSv1.2
Result : PASS
ATS with Forward Secrecy
Result : FAIL
若 Default ATS 为 FAIL,正确做法是修服务端(升级 TLS、换 ECDHE 套件、补全链),而不是改 App。只有在对接遗留内网系统、且短期无法升级时,才考虑域名级例外:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSExceptionDomains</key>
<dict>
<key>legacy.internal.example.com</key>
<dict>
<key>NSExceptionMinimumTLSVersion</key>
<string>TLSv1.1</string>
<key>NSExceptionRequiresForwardSecrecy</key>
<false/>
<key>NSIncludesSubdomains</key>
<true/>
</dict>
</dict>
</dict>
实践建议:NSAllowsArbitraryLoads 会让 App Store 审核要求逐条说明理由,尽量不用;例外域名控制在个位数,并在服务端升级后及时删除。
对比表格:错误码、根因与修复动作对照
| 错误码 | NSError 常量 | 典型根因 | 验证命令 | 修复动作 |
|---|---|---|---|---|
| -1200 | NSURLErrorSecureConnectionFailed | TLS 版本/套件不匹配 | openssl s_client -tls1_2 |
开启 TLS 1.2+,启用 ECDHE |
| -1201 | NSURLErrorServerCertificateHasBadDate | 证书过期或未生效 | openssl x509 -noout -dates |
续签证书并 reload |
| -1202 | NSURLErrorServerCertificateUntrusted | 链不完整、SHA-1、弱密钥、超 398 天 | openssl s_client -showcerts |
部署 fullchain,重签 SHA-256 |
| -1203 | NSURLErrorServerCertificateHasUnknownRoot | 私有 CA / 自签根未预置 | openssl verify -CAfile |
换公共 CA 或 MDM 预置根 |
| -1204 | NSURLErrorServerCertificateNotYetValid | 设备时间错误或 nbf 在未来 | date -u |
校准设备时间 / 重签 |
| -1205 | NSURLErrorClientCertificateRejected | mTLS 客户端证书被拒 | openssl s_client -cert |
检查双向认证配置 |
另一组常见对比:同一张证书,浏览器与 iOS 的行为差异。
| 场景 | 桌面浏览器 | iOS NSURLSession |
|---|---|---|
| 缺少中间证书 | AIA 自动补链,通常可打开 | 不做补链,直接 -1202 |
| SHA-1 签名 | 多数仍可访问并提示 | ATS 拒绝,-1202 |
| 有效期 > 398 天 | 可访问 | 判定不受信任,-1202 |
| 自签名证书 | 可手动点「继续」 | 无交互入口,-1203 |
这张表解释了「浏览器能开、App 打不开」的根本原因:两者的信任评估策略不同,iOS 更严格且无用户交互逃生通道。
常见错误排查:真实报错与对应处理
1)NSURLErrorDomain Code=-1202,但 Safari 能正常访问
先数链上证书张数:openssl s_client -showcerts ... | grep -c "BEGIN CERTIFICATE"。若结果为 1,就是缺中间证书,把 intermediate.pem 拼进 fullchain 即可。
2)curl 报 unable to get local issuer certificate
curl: (60) SSL certificate problem: unable to get local issuer certificate
More details here: https://curl.se/docs/sslcerts.html
与 -1202 同源,都是链不完整;不要用 curl -k 掩盖问题。
3)openssl verify 报 num=20 / num=21
verify error:num=20:unable to get local issuer certificate
verify error:num=21:unable to verify the first certificate
num=21 表示只拿到叶子证书;num=20 表示中间证书在但根不在信任库。
4)Go 客户端报 x509: certificate signed by unknown authority
私有 CA 未进入系统信任库,iOS 侧同样会报 -1203。
5)-1200 且 _kCFStreamErrorCodeKey=-9802
握手失败,多为服务端已禁用客户端要求的协议版本,或套件列表不含 ECDHE。用 openssl s_client -tls1_2 -cipher ECDHE-RSA-AES128-GCM-SHA256 单独验证。
6)日志出现 Certificate validity period is too long
证书有效期超过 398 天,SecTrustEvaluateWithError 返回 kSecTrustResultFatalTrustFailure,需重新签发。
7)主机名不匹配
用 openssl x509 -noout -ext subjectAltName 确认 SAN 是否含请求域名;通配符 *.example.com 只匹配一级子域,不匹配 a.b.example.com。
在 macOS 上抓 CFNetwork 日志可快速定位:
log stream --level debug --predicate 'subsystem == "com.apple.CFNetwork"'
效果验证:从服务端到真机的四层确认
改完配置不要只看浏览器,按下面四层逐级验证。
# L1 服务端配置生效
nginx -t && nginx -s reload
openssl s_client -connect api.example.com:443 -servername api.example.com -tls1_2 </dev/null
| grep "Verify return code"
# 期望:Verify return code: 0 (ok)
# L2 协议与套件枚举
nmap --script ssl-enum-ciphers -p 443 api.example.com
# 期望:只列出 TLSv1.2 / TLSv1.3,无 CBC、无 RSA 密钥交换
# L3 ATS 诊断
nscurl --ats-diagnostics https://api.example.com | grep -E "ATS Default Connection|Result"
# 期望:ATS Default Connection → Result : PASS
# L4 证书有效期与算法
openssl x509 -in fullchain.pem -noout -dates -text | grep -E "notAfter|Signature Algorithm"
App 侧加一段最小验证代码,把错误码打印出来,避免只看到一句「网络异常」:
let task = URLSession.shared.dataTask(with: url) { data, resp, err in
if let err = err as NSError? {
print("domain=" + err.domain + " code=" + String(err.code))
print(err.userInfo)
}
}
task.resume()
验收清单:Verify return code: 0 (ok);nscurl Default ATS 为 PASS;SSL Labs 评级 ≥ A;iOS 15/16/17 与 macOS 13+ 真机均无 -1202;证书剩余有效期不超过 398 天;链上证书 2~3 张。全部满足后,再回归登录、支付等关键链路,确认无证书 Pinning 冲突。
常见问题
桌面浏览器会自动发起 AIA 请求补全缺失的中间证书,iOS 的 Security 框架默认不做或不可靠,只校验服务端实际下发的链。用 openssl s_client -showcerts 统计证书数量,若只有 1 张就是链不完整,把中间证书拼进 fullchain 即可。
常见原因是签名算法为 SHA-1、公钥仅 RSA 1024,或有效期超过 398 天。Apple 自 2020-09-01 起强制 398 天上限,并要求 SHA-256 与 ≥2048 位密钥。用 openssl x509 -text 检查 Signature Algorithm 与 Public-Key,不合规就重新签发。
默认要求 TLS 1.2 及以上,且必须支持前向保密套件(ECDHE)。TLS 1.0/1.1 会直接失败。Nginx 配置 ssl_protocols TLSv1.2 TLSv1.3;,再用 nscurl –ats-diagnostics 验证 Default ATS 为 PASS 即可。
技术上可以,但不推荐。该键会让 App Store 审核要求逐条说明理由,同时显著降低传输安全性。优先修服务端;确需例外时用 NSExceptionDomains 做域名级最小化豁免,并配合证书 Pinning。
不能靠系统信任链通过校验。方案有二:把自签根 CA 通过 MDM 配置描述文件预置到设备信任列表;或在 App 内实现 URLSessionDelegate 的证书校验回调,做证书 Pinning 并比对根证书指纹。
有。必须叶子证书在前、中间证书在后,根证书可选且通常不放。顺序错误会导致部分客户端(含 iOS)构建链失败并报 -1202。可用 openssl verify -CAfile root.pem -untrusted intermediate.pem cert.pem 本地验证顺序是否正确。