JDK17+Gradle7.4环境下gradle war构建时npmInstall任务失败求助

问题根源 #

你使用的com.moowork.node插件是停更已久的第三方插件，完全不兼容Gradle 7.x新增的任务最新性严格校验规则——该规则要求任务的输入、输出必须显式添加注解，但插件里的NpmInstallTask类没给args和result属性加@Input/@Output注解，直接触发了构建报错。

修复步骤 #

1. 替换为Gradle官方维护的Node.js插件 #

Gradle官方有自己的Node插件，完全替代老旧的com.moowork.node，兼容Gradle 7.x的校验规则。

主项目build.gradle修改

如果是用plugins块引入插件，把旧的Node插件声明替换：

plugins {
    // 保留你原有其他插件
    id "com.github.node-gradle.node" version "3.5.1" // 选兼容Gradle7.4的版本
}

如果是用buildscript方式引入，修改依赖部分：

buildscript {
    repositories {
        // 保留原有仓库配置
    }
    dependencies {
        // 删除原有的com.moowork.node依赖
        classpath "com.github.node-gradle:gradle-node-plugin:3.5.1"
    }
}
apply plugin: "com.github.node-gradle.node"

2. 调整project-ui模块的Node配置 #

官方插件的配置参数和旧插件有差异，同步修改：

旧插件配置示例（你需要替换的部分）：

node {
    version = "16.13.0"
    npmVersion = "8.1.0"
    download = true
    workDir = file("${project.rootDir}/.node")
    npmWorkDir = file("${project.rootDir}/.npm")
}

npmInstall {
    args = ['--no-audit']
}

修改为官方插件的配置：

node {
    version = "16.13.0"
    npmVersion = "8.1.0"
    download = true
    nodeProjectDir = file(projectDir) // 指定package.json所在的项目目录
    workDir = file("${project.rootDir}/.node")
    npmWorkDir = file("${project.rootDir}/.npm")
}

// 官方插件用npmInstallOptions配置参数，替代旧的args属性
tasks.npmInstall {
    npmInstallOptions.addArguments('--no-audit')
}

3. 验证修复 #

执行清理+构建命令，确认问题解决：

./gradlew clean war

额外提醒 #

• 官方插件版本建议选3.5.1及以上，这个版本支持Gradle 6.1到7.x的全范围。
• 如果项目里还有其他依赖旧插件的任务（比如npmRunBuild），要替换成官方插件的对应任务（比如npmRun），参数配置逻辑也同步调整。

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