Blazor MAUI应用Google Play内部测试时Android端无法访问API求助

可能的原因及对应解决方法 #

1. 应用签名证书指纹与API服务器白名单不匹配 #

本地测试用的是debug keystore的签名指纹，而Google Play发布后采用的是官方App Signing的签名，若API服务器设置了仅允许特定指纹的应用访问，就会被拦截。

• 解决方法：
  • 登录Google Play Console，进入你的应用 -> 发布 -> 应用签名，复制SHA-1或SHA-256指纹；
  • 将该指纹添加到API服务器的白名单配置中（比如后端的Android应用签名验证逻辑）。

2. network_security_config配置在Release版本未生效 #

本地测试时配置正常，但Release构建可能存在配置遗漏或覆盖的情况。

• 解决方法：
  • 确认AndroidManifest.xml的application标签中已正确引用配置：android:networkSecurityConfig="@xml/network_security_config"；
  • 检查network_security_config.xml文件位于Resources/xml目录下，且在项目csproj文件中被标记为<AndroidResource Include="Resources\xml\network_security_config.xml" />，未被Release配置排除；
  • 验证配置文件中的域名规则是否正确，比如是否包含子域名、拼写无误：

    <?xml version="1.0" encoding="utf-8"?>
    <network-security-config>
        <domain-config cleartextTrafficPermitted="true">
            <domain includeSubdomains="true">your-api-domain.com</domain>
        </domain-config>
    </network-security-config>
    

3. ProGuard/R8混淆导致网络相关代码被破坏 #

Release构建默认启用ProGuard/R8混淆，若未保留Blazor、MAUI或HTTP相关类，会导致请求逻辑异常。

• 解决方法：
  • 在项目的proguard-rules.pro文件中添加以下规则：

    -keep class Microsoft.AspNetCore.Components.** { *; }
    -keep class Microsoft.Maui.** { *; }
    -keep class System.Net.Http.** { *; }
    -keep class YourAppNamespace.** { *; } // 替换为你的应用命名空间，避免业务代码被混淆
    

  • 确认csproj中Release配置已正确引用混淆规则文件：

    <PropertyGroup Condition="$(TargetFramework.Contains('-android')) and '$(Configuration)' == 'Release'">
        <AndroidEnableProguard>true</AndroidEnableProguard>
        <AndroidProguardRules>proguard-rules.pro</AndroidProguardRules>
    </PropertyGroup>
    

4. 未捕获具体错误信息导致定位模糊 #

仅知道“连接失败”无法精准判断问题，需要获取详细错误日志。

• 解决方法：
  • 在Blazor的HttpClient请求逻辑中添加异常捕获，记录错误详情（如DNS解析失败、证书错误、HTTP状态码等）；
  • 集成日志收集工具（如AppCenter），在Release版本中上传日志，便于排查具体问题。

5. Google Play权限声明异常 #

虽然INTERNET是正常权限，但偶尔会出现Play Console中权限未正确同步的情况。

• 解决方法：
  • 登录Google Play Console，进入应用 -> 政策与合规 -> 权限和功能，确认INTERNET权限已被正确声明并显示。

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