上架Google Play Store的Ionic安卓应用无法发起API调用求助

核心原因定位 #

本地签名APK联网正常说明基础代码和权限配置无逻辑错误，问题出在AAB打包/Google Play分发后的配置变更环节，属于AAB分发场景下的特有的异常问题。

可落地解决方案 #

1. 校验Play App Signing签名配置 #

Google Play默认会对上传的AAB进行重签名，若API服务商做了证书指纹校验，未配置Play后台的官方签名指纹就会导致请求被拦截：

• 进入Google Play控制台 → 目标应用 → 设置 → 应用签名，复制「应用签名证书」的SHA-1、SHA-256指纹
• 将上述指纹添加到你的API服务提供商的白名单中（包括自定义API网关、云服务、第三方开放平台都可能有该校验规则）

2. 强制保留声明权限，防止Google Play自动裁剪 #

部分版本的Google Play会对未判定为高频使用的权限做自动移除，你需要添加配置强制保留网络相关权限：

• 在gradle.properties文件中添加如下配置：

  android.bundle.permissions.keep = *
  

• 在AndroidManifest.xml中给网络权限添加tools:node="keep"标记，防止打包时被覆盖：

  <uses-permission android:name="android.permission.INTERNET" tools:node="keep" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" tools:node="keep" />
  

3. 检查network_security_config.xml配置 #

你的manifest中已开启自定义网络安全配置，且禁用了明文流量传输，需要确认该配置没有仅适配本地调试环境：

<!-- 正确配置示例，确保生产域名在允许列表中 -->
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="false">
        <domain includeSubdomains="true">你的生产环境API域名</domain>
    </domain-config>
    <!-- 不要仅保留debug-overrides节点，否则生产环境会无合法域名配置 -->
    <debug-overrides>
        <trust-anchors>
            <certificates src="user"/>
        </trust-anchors>
    </debug-overrides>
</network-security-config>

4. 本地验证AAB包的有效性 #

使用Google官方的bundletool工具将AAB转为APK本地安装测试，确认打包环节无异常：

• 生成APK集命令：

  java -jar bundletool.jar build-apks --bundle=你的应用.aab --output=app.apks --ks=你的签名文件.keystore --ks-key-alias=签名别名 --ks-pass=pass:密钥库密码 --key-pass=pass:别名密码
  

• 安装到测试设备命令：

  java -jar bundletool.jar install-apks --apks=app.apks
  

如果该安装包也出现联网异常，说明问题出在本地AAB打包环节，否则就是Google Play后台配置问题。

5. 排除Ionic插件混淆裁剪问题 #

在安卓混淆规则文件中添加网络相关插件的排除规则，防止打包时插件代码被裁剪：

-keep class org.apache.cordova.** { *; }
-keep class com.getcapacitor.** { *; }
-keep class io.ionic.** { *; }

优先排查顺序 #

建议按照步骤4 → 步骤1 → 步骤2 → 步骤3 → 步骤5的顺序验证，90%以上的同类问题都是API服务未配置Play签名证书指纹，或者AAB打包时权限被自动移除导致的。

内容的提问来源于stack exchange，提问作者A. Gh