如何在Xcode SwiftUI预览环境中安装并信任内部CA根证书

问题背景 #

• 场景：使用AsyncImage加载由内部证书颁发机构签名的企业HTTPS服务器图片资源时，SwiftUI预览环境始终加载失败，根因为预览环境不信任该内部CA
• 已验证无效的配置路径：
  • 将内部CA根证书导入对应iOS模拟器并标记为完全受信任，App构建后在模拟器中可正常加载图片，但模拟器配置不被Xcode内嵌SwiftUI预览继承
  • 将内部CA根证书安装到宿主Mac钥匙串并设置为全局信任，该配置同样无法影响SwiftUI预览隔离环境

可行临时适配方案 #

SwiftUI预览运行在独立的进程沙箱中，截至当前最新稳定版Xcode，苹果未提供直接向预览沙箱导入受信任根证书的官方入口，可通过自定义网络层的方式绕开证书校验限制，不影响正式发布版本安全性：

1. 将内部CA根证书文件（.cer格式）拖入工程Target，确保预览环境可从Main Bundle读取到该文件
2. 自定义内置根证书校验逻辑的URLSession实例，仅在DEBUG/预览环境下启用自定义证书信任逻辑，正式环境走系统默认校验流程，核心实现代码如下：

import SwiftUI

extension URLSession {
    static let corporateTrusted: URLSession = {
        let configuration = URLSessionConfiguration.default
        // 读取Bundle内的内部CA根证书
        guard let certURL = Bundle.main.url(forResource: "internal-ca-root", withExtension: "cer"),
              let certData = try? Data(contentsOf: certURL),
              let rootCert = SecCertificateCreateWithData(nil, certData as CFData) else {
            return .shared
        }
        let trustDelegate = CACertTrustDelegate(trustedRootCert: rootCert)
        return URLSession(configuration: configuration, delegate: trustDelegate, delegateQueue: nil)
    }()
}

class CACertTrustDelegate: NSObject, URLSessionDelegate {
    private let trustedRootCert: SecCertificate
    
    init(trustedRootCert: SecCertificate) {
        self.trustedRootCert = trustedRootCert
    }
    
    func urlSession(_ session: URLSession,
                    didReceive challenge: URLAuthenticationChallenge,
                    completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {
        #if DEBUG
        guard challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodServerTrust,
              let serverTrust = challenge.protectionSpace.serverTrust else {
            completionHandler(.performDefaultHandling, nil)
            return
        }
        // 将内置CA证书加入当前请求的信任锚点
        SecTrustSetAnchorCertificates(serverTrust, [trustedRootCert] as CFArray)
        SecTrustSetAnchorCertificatesOnly(serverTrust, true)
        
        var evalResult = SecTrustResultType.invalid
        SecTrustEvaluate(serverTrust, &evalResult)
        if evalResult == .proceed || evalResult == .unspecified {
            completionHandler(.useCredential, URLCredential(trust: serverTrust))
            return
        }
        #endif
        completionHandler(.performDefaultHandling, nil)
    }
}

// 适配AsyncImage调用
extension AsyncImage where Content == View {
    init(trustedCorporateURL: URL?,
         @ViewBuilder content: @escaping (AsyncImagePhase) -> Content) {
        self.init(url: trustedCorporateURL, urlSession: .corporateTrusted, content: content)
    }
}

3. 调用时替换原AsyncImage初始化方法为适配后的信任版本，即可在预览环境正常加载企业HTTPS资源。

相关说明 #

该问题已向苹果提交官方反馈，反馈编号为FB10667327，若后续Xcode版本开放SwiftUI预览沙箱的证书配置入口，可直接通过系统级信任配置实现，无需代码适配。

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