跳到主要内容

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 本地验证顺序是否正确。