You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native使用axios时安卓7及以下系统API连接报错如何解决?

问题根因

安卓7.0及更低版本系统默认未给应用层启用TLS 1.2及以上协议支持,目前绝大多数公开HTTPS服务都已正式停用安全性不足的TLS 1.0/1.1协议,旧设备发起HTTPS请求时握手直接失败,axios底层调用系统原生网络栈,会抛出无明确信息的Network Error报错。
注:安卓4.4及以上系统本身已内置TLS 1.2支持,只是默认未启用,无需额外移植协议实现。

修复方案
  • 方案1:原生层全局启用TLS 1.2(最推荐,无业务侵入)
    针对Cordova/React Native/uni-app等跨端框架打包的安卓应用,直接在原生Android工程的Application初始化逻辑中添加TLS 1.2强制启用配置即可,无需修改前端业务代码。
    安卓原生Java配置示例:

    import android.os.Build;
    import com.google.android.gms.security.ProviderInstaller;
    import javax.net.ssl.SSLContext;
    
    public class MyApplication extends Application {
        @Override
        public void onCreate() {
            super.onCreate();
            // 仅针对安卓7及以下版本做兼容
            if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.N) {
                try {
                    // 升级系统安全提供器
                    ProviderInstaller.installIfNeeded(getApplicationContext());
                    SSLContext sslContext = SSLContext.getInstance("TLSv1.2");
                    sslContext.init(null, null, null);
                    sslContext.createSSLEngine();
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        }
    }
    

    如应用不依赖Google Play服务,可引入开源的TLS兼容库替代ProviderInstaller实现

  • 方案2:axios层适配兼容(适合无法修改原生代码的场景)
    在axios实例初始化时调整配置,优先使用XHR adapter,测试环境可临时关闭证书校验做快速验证(生产环境禁止开启,存在安全风险)。
    前端JS代码示例:

    import axios from 'axios';
    
    const requestInstance = axios.create({
      baseURL: '你的业务接口域名',
      timeout: 15000,
      // 强制使用XHR适配器,部分跨端环境默认的http adapter对低版本SSL兼容差
      adapter: require('axios/lib/adapters/xhr'),
      // 仅测试环境临时使用,生产环境必须移除
      rejectUnauthorized: false
    });
    
  • 方案3:服务端兼容旧版TLS协议(仅适用于极特殊场景)
    如果业务必须覆盖无Google Play服务、连原生安全提供器都无法升级的极旧设备,可联系运维在HTTPS站点的SSL配置中保留TLS 1.1/1.0的支持,需提前评估安全风险。

快速验证方法
  • 用旧设备的系统原生浏览器直接访问你的HTTPS接口地址,如果无法正常打开返回结果,可直接确认是系统TLS协议兼容问题,和axios上层代码无关。

内容的提问来源于stack exchange,提问作者Vicky

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.02 14:45:01