NX Monorepo：如何用单个Maven Wrapper替代子模块独立Wrapper

解决方案步骤 #

1. 放置统一的Maven Wrapper文件 #

将完整的Maven Wrapper文件包（包括mvnw、mvnw.cmd以及.mvn文件夹）放到仓库根目录（与apps文件夹同级的位置）。

注意：不能只复制mvnw脚本，.mvn目录包含了Maven Wrapper的核心配置（比如wrapper/maven-wrapper.properties），缺失会导致无法正常工作。

2. 配置NX使用父模块的Wrapper #

有两种配置方式，选其一即可：

方式一：全局配置（所有Java项目生效）

编辑根目录的nx.json，在defaults节点下添加Maven任务的默认配置：

{
  "defaults": {
    "@nx/java:maven": {
      "useParentMavenWrapper": true
    }
  }
}

方式二：单个项目配置（针对特定子应用）

编辑目标子应用的project.json（比如apps/java/app1/project.json），在对应Maven任务的options中启用父Wrapper：

{
  "targets": {
    "install": {
      "executor": "@nx/java:maven",
      "options": {
        "goals": ["install"],
        "useParentMavenWrapper": true
      }
    },
    // 其他Maven任务（如build、test）也可添加相同配置
    "build": {
      "executor": "@nx/java:maven",
      "options": {
        "goals": ["package"],
        "useParentMavenWrapper": true
      }
    }
  }
}

3. 验证配置 #

删除所有子应用（app1、app2等）下的mvnw、mvnw.cmd和.mvn文件夹，然后执行命令测试：

nx install app1

此时NX会自动调用根目录的Maven Wrapper完成操作。

错误原因说明 #

你之前遇到的报错⚠️ You chose not to use the Maven wrapper from the parent module, but no wrapper was found in current child module，是因为：

• 未在NX配置中启用useParentMavenWrapper，NX默认会优先查找子应用本地的Wrapper
• 可能只复制了mvnw脚本，缺失了.mvn配置目录，导致根目录的Wrapper无法被NX识别

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