Flutter/Dart应用模拟器正常但APK真机服务器通信异常求助

数据老陈

2026-7-27

针对Release APK无法与Server One通信的排查方向

检查混淆配置：Release模式默认开启R8混淆，若你的网络请求依赖（如http、dio）未添加对应的混淆规则，可能导致请求逻辑被破坏。打开android/app/build.gradle，查看minifyEnabled是否为true，若开启，需在proguard-rules.pro中添加依赖包的混淆规则（例如dio的规则：-keep class com.chuckerteam.chucker.api.** { *; }，具体参考依赖官方文档）。
验证网络安全配置：若Server One使用自签名HTTPS证书，Release模式下Flutter默认拒绝不安全连接。需在android/app/src/main/res/xml创建network_security_config.xml，添加允许该域名的配置，再在AndroidManifest.xml的application标签中引用：android:networkSecurityConfig="@xml/network_security_config"。示例配置：
```
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">你的Server One域名/IP</domain>
    </domain-config>
</network-security-config>
```
确认环境变量加载：若使用环境变量管理Server地址（如flutter_dotenv），需确保Release模式下.env文件已正确打包。检查pubspec.yaml中是否将.env添加到assets，并在代码中完成正确初始化。

检查服务器网络可达性：用手机浏览器直接访问Server Two的API地址，确认真机所在网络能正常获取响应。若Server Two是本地服务器，模拟器通过10.0.2.2映射本地，但真机需使用局域网IP，同时确保服务器防火墙开放对应端口，且允许真机IP访问。
处理明文HTTP限制：Android 9及以上默认禁止明文HTTP请求，若Server Two使用HTTP协议，需通过上述network_security_config.xml配置允许该域名的明文流量，或升级Server Two为HTTPS。
排查请求逻辑错误：在代码中添加日志打印请求详情（URL、参数、请求头），通过flutter logs命令查看真机运行时的日志，确认是否存在路径错误、参数格式不匹配、响应状态码异常（如404、500）等问题。
检查代理设置：若真机开启了代理，可能导致无法访问Server Two，尝试关闭代理后再测试。

查看Flutter日志：运行flutter logs，连接真机后操作应用，获取网络请求相关的错误信息（如SocketException、HttpException），这是定位问题最直接的方式。
测试HTTPS兼容性：若服务器使用HTTPS，通过手机浏览器访问API，确认证书是否有效（无证书错误提示），避免因证书不被系统信任导致请求失败。

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