React Native WebView加载网站出现SSL证书信任错误求助

阿华AIGC实验室

2026-3-27

兄弟，我来帮你捋捋这个问题！你遇到的这个SSL证书信任报错，虽然你提到网站有正常SSL，但React Native的WebView对证书校验的逻辑和普通浏览器不太一样，再加上你用的是PHP 5.6这种比较老的版本搭建的站点，大概率是这几个原因导致的：

先把你遇到的错误信息贴出来方便对照：

error loading page. Domain: undefined. Error code: 3. Description: SSL error: The certificate authority is not trusted.

下面是具体的排查和解决方向：

证书链配置不完整：这是最常见的原因！很多时候网站的主证书没问题，但服务器没配置完整的中间证书链。普通浏览器会自动尝试补全缺失的中间证书，但React Native的WebView（尤其是Android端的内核）不会做这个操作，直接就判定证书机构不被信任。你可以用SSL检测工具查一下站点的证书链是否完整，如果确实缺中间证书，把它添加到服务器的SSL配置里：
- Nginx：在ssl_certificate下面加上ssl_certificate_chain /path/to/中间证书文件.pem;
- Apache：配置SSLCertificateChainFile /path/to/中间证书文件.pem;
TLS协议版本过旧：PHP 5.6默认支持的TLS版本偏老（比如TLS 1.0、1.1），而现在React Native的WebView普遍要求至少TLS 1.2及以上的加密协议。你需要修改服务器的TLS配置，启用高版本协议并禁用过时的：
- Nginx：设置ssl_protocols TLSv1.2 TLSv1.3;
- Apache：设置SSLProtocol -ALL +TLSv1.2 +TLSv1.3;
调试环境临时绕过校验（生产环境绝对禁用！）：如果你只是在本地调试阶段想先验证网站内容能不能正常加载，可以临时关闭WebView的SSL校验，但上线前一定要删掉这个配置：
- 对于React Native官方WebView，Android端可以在onReceivedSslError回调里调用handler.proceed()，示例代码：
```
<WebView
  source={{ uri: '你的站点地址' }}
  onReceivedSslError={(event, handler) => {
    // 仅调试用，生产环境必须删除
    handler.proceed();
    // 生产环境应该用handler.cancel()，并提示用户证书错误
  }}
/>
```
- iOS端可以在Info.plist里添加NSAppTransportSecurity的例外配置，但同样只适合调试。
证书本身的信任问题：如果你用的是小众CA颁发的证书，可能在部分移动系统的信任列表里没有，导致WebView不认可。建议换成主流CA的证书，比如Let's Encrypt的免费证书，现在几乎所有主流移动系统都信任它。