Flutter Release模式下部分Android设备无法连接服务端问题求助

问题诱因排查 #

1. TLS版本与加密套件兼容性问题 #

• 故障设备为Android 8.0版本，当前绝大多数线上服务默认仅启用TLS 1.2及以上版本的加密协议，部分三星定制ROM的Android 8.0版本默认未强制启用TLS 1.2/1.3，且不支持部分新的SSL加密套件，会导致SSL握手失败，连接超时。
• 验证方法：可在故障设备上用系统浏览器打开你的API域名，若浏览器也提示证书错误/无法连接，基本可以确定是SSL兼容性问题。

2. 网络安全配置冲突/错误 #

• 你同时在AndroidManifest.xml中配置了android:usesCleartextTraffic="true"和自定义networkSecurityConfig，二者优先级以networkSecurityConfig为准，如果该配置文件中存在域名过滤、证书绑定错误、未包含你的API域名规则，会直接导致合法请求被拦截。

3. 系统后台联网限制 #

• 三星设备的电池优化策略非常严格，未加入电池优化白名单的应用，在后台运行或者锁屏后会被系统禁止联网，直接触发请求超时。

4. Flutter HTTP依赖适配问题 #

• 如果你使用的http包版本低于0.13.0，或者底层依赖的okhttp版本过低，会存在低版本Android系统的网络适配bug，导致请求失败。

5. 请求头语法错误 #

• 你贴出的请求代码中，headers配置的键accept如果是字符串常量，未添加引号会被识别为变量，若未定义accept变量会导致请求头构造错误，请求被服务器拒绝。

对应解决方案 #

方案1：修复TLS兼容性问题 #

• 在Android原生层Application的onCreate方法中添加全局SSL配置，强制为低版本Android启用TLS 1.2/1.3支持：

if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.O) {
    try {
        SSLContext sc = SSLContext.getInstance("TLSv1.2");
        sc.init(null, null, null);
        HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());
    } catch (Exception e) {
        e.printStackTrace();
    }
}

• 联系服务端运维，确认SSL配置中已启用对TLS 1.2的支持，且添加了Android 8.0支持的加密套件：TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384等。

方案2：校验并修正网络安全配置 #

• 暂时注释掉AndroidManifest.xml中的android:networkSecurityConfig="@xml/network_security_config"配置，测试是否能正常请求，如果恢复正常说明networkSecurityConfig规则存在错误，需要调整：
  • 确认配置中已添加你的API域名panel.test.ir的放行规则
  • 移除错误的证书绑定配置
  • 若无证书绑定需求，可以直接使用以下通用配置：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>

方案3：引导用户关闭电池优化 #

• 在应用首次启动时，弹出引导框，引导用户将应用加入三星电池优化白名单，跳转代码示例：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    Intent intent = new Intent();
    String packageName = getPackageName();
    PowerManager pm = (PowerManager) getSystemService(POWER_SERVICE);
    if (!pm.isIgnoringBatteryOptimizations(packageName)) {
        intent.setAction(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
        intent.setData(Uri.parse("package:" + packageName));
        startActivity(intent);
    }
}

• 在AndroidManifest.xml中添加对应权限：<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

方案4：升级Flutter网络依赖 #

• 将pubspec.yaml中的http包升级到0.13.5及以上稳定版本，或者替换为适配性更好的dio包，底层默认兼容低版本Android的TLS配置。

方案5：修正请求头语法 #

// 修正后的请求头写法
headers: {
  "Accept" : acceptValue
}

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