React Native项目编译失败：无法解析firebase-messaging依赖（SSL问题）

问题详情 #

执行:app:compileDebugJavaWithJavac任务时失败，错误信息如下：

无法确定任务':app:compileDebugJavaWithJavac'的依赖项。

无法解析配置':app:debugCompileClasspath'的所有依赖项。

无法解析com.google.firebase:firebase-messaging:{require [21.0.0, 23.4.99]; prefer 23.4.0}。

被以下依赖引用：project :app > com.onesignal:notifications:5.1.23

无法列出com.google.firebase:firebase-messaging的版本。
无法从https://dl.google.com/dl/android/maven2/com/google/firebase/firebase-messaging/maven-metadata.xml加载Maven元数据。
无法HEAD请求上述URL。
请求期间发生SSL握手异常，可能由SSL配置错误导致。
PKIX路径构建失败：sun.security.provider.certpath.SunCertPathBuilderException: 无法找到请求目标的有效证书路径

环境信息 #

• React Native版本：0.75.4
• JDK版本：17
• Gradle包装器：gradle-8.8-all.zip
• 依赖包：react-native-onesignal: ^5.2.5

解决方法 #

1. 导入Google Maven仓库SSL证书到JDK信任库 #

1. 打开浏览器访问https://dl.google.com，通过地址栏的锁图标导出网站SSL证书（保存为DER编码二进制X.509格式）
2. 执行JDK的keytool命令导入证书：

   keytool -import -alias google-maven -keystore $JAVA_HOME/lib/security/cacerts -file /path/to/your/certificate.cer
   

   默认信任库密码为changeit，按提示输入完成导入。

2. 临时关闭Gradle SSL证书验证（仅开发环境） #

在项目根目录的build.gradle中修改仓库配置：

allprojects {
    repositories {
        // 保留原有仓库配置
        maven {
            url "https://dl.google.com/dl/android/maven2/"
            allowInsecureProtocol = true
        }
    }
}

⚠️ 注意：此方法仅用于开发调试，生产环境禁止使用，存在安全风险。

3. 排查网络代理问题 #

若使用代理，确认代理配置未拦截SSL请求，可尝试关闭代理后重新执行构建：

./gradlew clean :app:compileDebugJavaWithJavac

4. 校验JDK与Gradle版本兼容性 #

确保使用官方稳定版JDK 17，Gradle 8.8与React Native 0.75.4适配，可重新下载Gradle包装器或升级至匹配版本。

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