Ionic 5发布版请求Laravel 8接口无响应故障咨询

日志中的net_error -202对应Chromium内核的NET::ERR_CERT_AUTHORITY_INVALID错误，本质是SSL握手阶段APP端判定服务端证书不受信任，debug与release版本的表现差异由Android系统的网络安全策略差异导致，与业务逻辑、API Key鉴权规则无关。

• Android 7及以上系统中，debug版本的应用默认信任系统根证书、用户手动安装的自定义证书，因此测试环境的自签证书、私有CA证书都可以正常通过校验
• release版本的应用默认仅信任系统预装的根CA证书，若服务端使用自签证书、私有CA签发证书、过期证书、域名与证书不匹配的证书，都会触发证书校验失败，导致握手终止
• 打包release版本时若开启了代码混淆、资源压缩，可能意外移除自定义的网络安全配置文件，导致已配置的证书信任规则失效
• 后端服务若仅支持TLS 1.0/1.1等旧版本协议，新版Android系统的WebView默认禁用旧TLS协议，也会触发握手失败

1. 优先替换为公共可信证书 #

使用公共可信CA（如Let's Encrypt）签发的免费证书部署到后端，无需修改APP配置即可适配所有版本的应用，是生产环境的最优方案。可通过以下命令验证证书有效性：
curl -v https://你的后端接口域名
确认返回的证书状态无过期、域名不匹配、签发机构不可信等问题。

2. 配置自定义网络安全规则（仅适用于必须使用私有/自签证书的场景） #

在Ionic项目的Android原生目录android/app/src/main/res/下创建xml文件夹，新增network_security_config.xml文件：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="false">
        <domain includeSubdomains="true">替换为你的后端接口域名</domain>
        <trust-anchors>
            <certificates src="system" />
            <!-- 若使用自签证书，将证书文件放到res/raw目录下，在此处引用 -->
            <certificates src="@raw/你的证书文件名" />
            <!-- 测试阶段临时开启：信任用户安装的证书，生产环境务必注释 -->
            <!-- <certificates src="user" /> -->
        </trust-anchors>
    </domain-config>
</network-security-config>

之后修改android/app/src/main/AndroidManifest.xml，在application标签中添加属性：
android:networkSecurityConfig="@xml/network_security_config"

3. 排查混淆与TLS版本配置 #

• 检查android/app/proguard-rules.pro文件，添加网络请求相关类的混淆排除规则，避免核心类被错误混淆：

-keep class okhttp3.** { *; }
-keep interface okhttp3.** { *; }
-dontwarn okhttp3.**

可根据你使用的请求库调整对应的排除规则。

• 确认后端服务的TLS配置，至少开启TLS 1.2及以上版本，关闭TLS 1.0/1.1，适配新版Android系统的安全要求。

4. 临时调试方案（仅用于排查问题） #

在Android项目的主Activity中添加代码，开启release版本的WebView调试权限：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    WebView.setWebContentsDebuggingEnabled(true);
}

打包安装后，在Chrome浏览器地址栏输入chrome://inspect即可连接APP的WebView，直接查看网络请求的详细报错信息，快速定位问题。

内容的提问来源于stack exchange，提问作者Collins Amanya