React Native执行run-android时报SSLException: Tag mismatch错误求助

版本信息 #

react native:0.68.2
react native cli: 2.0.1
node:v18.13.0
jdk:jdk-8.0.342.07-hotspot

问题描述 #

执行npx react-native run-android或react-native run-android时，在下载Gradle 7.3.3-all.zip阶段抛出核心异常：javax.net.ssl.SSLException: Tag mismatch!。已尝试修改android\gradle\wrapper\gradle-wrapper.properties中的distributionUrl切换http/https协议，网络连接稳定，项目为全新HelloWorld无额外依赖，此前安装Android Studio时也曾出现相同错误。

关键错误日志片段：

Downloading https://services.gradle.org/distributions/gradle-7.3.3-all.zip

Exception in thread "main" javax.net.ssl.SSLException: Tag mismatch!
Caused by: javax.crypto.AEADBadTagException: Tag mismatch!

解决方案 #

按优先级尝试以下方案：

1. 手动下载Gradle并配置本地缓存 #

• 下载对应版本的gradle-7.3.3-all.zip
• 找到本地Gradle缓存目录：Windows系统一般为C:\Users\<你的用户名>\.gradle\wrapper\dists\gradle-7.3.3-all\<随机生成的字符串>，若目录不存在则手动创建
• 将下载好的zip文件放入该目录，无需解压
• 重新执行react-native run-android，Gradle会直接读取本地文件，跳过下载流程

2. 临时禁用SSL证书验证（不推荐长期使用） #

执行命令时添加参数跳过SSL校验：

set GRADLE_OPTS="-Djavax.net.ssl.trustStoreType=JKS -Djavax.net.ssl.trustStorePassword=changeit" && npx react-native run-android

或修改gradle-wrapper.properties，注释掉distributionSha256Sum配置项，确保distributionUrl指向可靠路径。

3. 更新或切换JDK版本 #

当前JDK 8的GCM加密算法可能存在兼容性问题：

• 升级JDK 8至最新补丁版本（如jdk8u381及以上）
• 临时切换到JDK 11，React Native 0.68.x对JDK 11兼容良好
• 若使用低版本JDK 8，需手动安装无限制强度的JCE政策文件（JDK 8u151及以上默认已包含）

4. 替换Gradle下载镜像源 #

修改android\build.gradle中的仓库配置，使用国内镜像加速：

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
        google()
        mavenCentral()
    }
    // 保留原文件其他内容
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
        google()
        mavenCentral()
    }
}

同时修改gradle-wrapper.properties的distributionUrl为国内镜像地址：

distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-7.3.3-all.zip

注意事项 #

• 手动下载Gradle时，建议校验文件哈希值与官方提供的一致，避免因文件损坏导致后续构建失败
• 禁用SSL验证仅作为临时测试方案，长期使用请确保网络环境安全并选择可靠镜像源

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