MavenCentral被屏蔽时，如何处理NPM引入的React Native Android依赖？

核心方案：Gradle初始化脚本（Init Script） #

这是最可靠的全局覆盖方式，无需修改任何第三方库的build.gradle文件，直接在Gradle初始化阶段统一替换所有仓库配置。

步骤1：创建初始化脚本 #

在项目根目录下新建init.gradle文件（若放在~/.gradle/init.d/目录下，可实现本地所有项目全局生效），内容如下：

allprojects {
    repositories {
        // 移除所有已配置的mavenCentral仓库
        removeIf { it instanceof MavenArtifactRepository && it.url.toString().contains("mavenCentral") }
        // 添加内部Nexus代理仓库
        maven {
            url "http://your-internal-nexus-url/repository/maven-proxy/"
            // 若仓库需要认证，补充以下配置
            credentials {
                username = "nexus-username"
                password = "nexus-password"
            }
        }
        // 保留项目必需的其他仓库
        google()
        mavenLocal()
    }
}

步骤2：配置Gradle加载脚本 #

• 项目级生效：在项目根目录的gradle.properties中添加：

  org.gradle.init.script=init.gradle
  

• 全局生效：将init.gradle放入用户目录的.gradle/init.d/文件夹（Windows路径：C:\Users\<你的用户名>\.gradle\init.d\；Mac/Linux路径：~/.gradle/init.d/），本地所有Gradle构建会自动加载该脚本。

React Native专属优化：利用框架自带的仓库统一配置 #

React Native 0.70+版本的Gradle插件支持集中管控仓库，可在项目根目录的settings.gradle中修改：

pluginManagement {
    repositories {
        maven { url "http://your-internal-nexus-url/repository/maven-proxy/" }
        google()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url "http://your-internal-nexus-url/repository/maven-proxy/" }
        google()
        mavenLocal()
    }
}

其中RepositoriesMode.FAIL_ON_PROJECT_REPOS会强制所有子项目（包括NPM依赖的Android模块）使用此处定义的仓库，禁止子项目自行添加外部仓库，从根源上避免第三方库引入公共仓库。

备选方案：自定义Gradle插件（企业级统一管控） #

若需要更灵活的规则（比如按依赖组过滤仓库），可编写自定义Gradle插件：

1. 在项目中新建buildSrc模块，创建插件类：

import org.gradle.api.Plugin
import org.gradle.api.Project

class RepositoryOverridePlugin : Plugin<Project> {
    override fun apply(project: Project) {
        project.allprojects {
            repositories {
                removeIf { it.url.toString().contains("mavenCentral") }
                add(maven {
                    url = uri("http://your-internal-nexus-url/repository/maven-proxy/")
                })
            }
        }
    }
}

2. 在根项目的build.gradle中应用插件：

plugins {
    id 'repository-override' version '1.0' apply false
}

allprojects {
    apply plugin: 'repository-override'
}

验证方法 #

执行./gradlew dependencies命令，查看所有依赖的解析路径，确认无资源从mavenCentral拉取，全部走内部Nexus代理。

内容的提问来源于stack exchange，提问作者Henry Grant