解决React Native集成中Gradle调用NPM失败问题

1. 问题现象与背景分析

最近在Android项目中集成React Native时，遇到了一个棘手的问题：Gradle构建过程中调用NPM命令总是失败。控制台报错显示"npm不是内部或外部命令"，但直接在终端执行npm -v却能正常显示版本号。这种环境变量"时灵时不灵"的情况，在混合开发中尤为常见。

根本原因在于Gradle的执行环境与系统终端环境存在差异。当我们在Android Studio中运行Gradle任务时，它使用的是自己的环境上下文，可能不包含用户手动添加到.bashrc或.zshrc中的PATH配置。特别是在Windows系统上，如果Node.js不是通过管理员权限安装的，更容易出现权限继承问题。

2. 环境变量深度解析

2.1 系统PATH与用户PATH的区别

Windows系统中存在两个层级的PATH变量：

• 系统PATH：对所有用户生效，位于"系统属性->高级->环境变量"
• 用户PATH：仅对当前用户生效，优先级高于系统PATH

通过以下命令可以查看Gradle实际获取到的PATH值：

groovy复制task checkPath {
    doLast {
        println "PATH: " + System.getenv('PATH')
    }
}

2.2 Gradle的env继承机制

Gradle默认继承的是启动它的父进程环境。在Android Studio中运行时，实际经历了：
IDE → Gradle Daemon → 你的构建任务

这个过程中，环境变量可能会被过滤或重写。可以通过在gradle.properties中添加：

code复制org.gradle.daemon=false

关闭守护进程来测试是否为继承链问题。

3. 解决方案对比

3.1 方案一：绝对路径调用（推荐）

最可靠的方案是直接使用Node.js的绝对路径。首先通过where命令定位可执行文件：

groovy复制def findNpm() {
    if (System.getProperty('os.name').toLowerCase().contains('windows')) {
        return 'cmd /c where npm'