NX Monorepo中.m2依赖缓存冲突问题求助

AI 小北

2026-6-12

解决NX Monorepo中spring-boot插件缓存导致Maven依赖未找到的问题

核心问题原因

更新pom.xml后，NX缓存了子模块的install任务，跳过了实际将jar包安装到本地.m2仓库的步骤；而GitHub Actions的Maven缓存此时会重建，但缺失了本地子模块的依赖jar，导致后续构建报错。

解决方案

1. 配置NX任务缓存规则，避免install任务被不当缓存

修改项目根目录的nx.json，针对spring-boot:install任务调整缓存策略：

方案A：直接禁用install任务的NX缓存（简单直接，适合依赖变动不频繁的场景）

{
  "targetDefaults": {
    "spring-boot:install": {
      "cache": false,
      "dependsOn": ["^spring-boot:install"]
    }
  }
}

方案B：精准配置缓存失效条件，当项目或依赖的pom.xml变更时，自动失效install任务的缓存（兼顾缓存效率与正确性）
在子模块的project.json中添加：
```
{
  "targets": {
    "install": {
      "executor": "@nxrocks/spring-boot:install",
      "inputs": [
        "default",
        "^default",
        "{projectRoot}/pom.xml",
        "**/pom.xml"
      ]
    }
  }
}
```
这样只要任意子模块的pom.xml修改，对应的install任务缓存就会失效，强制重新执行安装。

2. 在GitHub Actions中针对性跳过NX缓存

在CI构建步骤中，判断pom.xml是否有变更，若有则强制跳过NX缓存执行install：

- name: Restore Maven cache
  id: cache-maven
  uses: actions/cache@v3
  with:
    path: ~/.m2/repository
    key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}

- name: Install submodules (fresh if pom changed)
  run: |
    if [ "${{ steps.cache-maven.outputs.cache-hit }}" != "true" ]; then
      nx run-many --target=install --all --skip-nx-cache
    else
      nx run-many --target=install --all
    fi

这个逻辑会在Maven缓存重建时（即pom变更），强制重新执行所有子模块的install，确保本地.m2仓库包含最新的子模块jar。