Maven类路径选择逻辑及generate-sources执行问题咨询

1. 为什么compile正常但generate-sources失败？ #

这背后的核心原因是Maven执行生命周期阶段时的依赖解析时机和Reactor构建深度不同：

• 当执行compile目标时，-am参数会触发Maven先构建sub-prj的compile阶段——这会生成sub-prj/target/classes目录，Maven会自动将这个目录加入gen-src-prj的类路径，完全不需要去仓库寻找Jar包。
• 但执行generate-sources目标时，-am只会让Maven构建sub-prj的generate-sources阶段（和指定的目标阶段保持一致），sub-prj并没有执行compile，所以既没有生成Jar包，也没有可供依赖的target/classes目录。此时Maven会默认尝试从本地/远程仓库解析sub-prj的依赖，而你又没执行mvn install把构件推到仓库，自然会抛出找不到依赖的错误。
  另外要注意：Maven在执行任何阶段前，都会先完成所有依赖的可解析性验证——哪怕你的代码生成工具根本不需要这些依赖，默认流程里这一步也会触发。

2. Maven何时选择Reactor中前置项目的输出目录而非仓库Jar？ #

Maven会在以下场景优先使用Reactor内模块的输出目录（而非仓库中的Jar包）：

• 当你执行的生命周期阶段至少包含compile阶段时：此时Maven会确保依赖模块已经完成compile，生成target/classes目录，并将这个目录作为依赖路径使用。
• 依赖模块的版本为SNAPSHOT且存在于当前Reactor中：Maven会优先选用Reactor内的构建输出，而非仓库里的SNAPSHOT Jar——但前提是依赖模块已经执行到足够的阶段，生成了可被依赖的输出（比如compile阶段生成的classes目录）。
• 使用-am/-amd参数时，Maven会同步构建依赖模块到与目标阶段匹配的程度，但只有当目标阶段包含compile或更靠后的阶段时，才会生成可被依赖的输出目录。

3. 能否在不解析依赖的情况下直接运行generate-sources？ #

当然可以，因为你的代码生成工具只读取XML文件，完全不需要类路径依赖，这里提供两种实用方案：

• 方案一：命令行跳过依赖解析
  执行命令时添加参数，强制Maven跳过所有依赖的解析和下载步骤：

  mvn -am -pl parent-prj/gen-src-prj generate-sources -Dmaven.dependency.skip=true
  

  这个参数会让Maven直接进入指定阶段的执行，跳过依赖验证环节。

• 方案二：在插件配置中跳过依赖解析
  如果你是通过exec-maven-plugin调用代码生成工具，可以在插件配置里添加skipDependencyResolution参数，让插件执行时不触发依赖解析：

  <plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
      <execution>
        <id>generate-sources</id>
        <phase>generate-sources</phase>
        <goals>
          <goal>exec</goal>
        </goals>
        <configuration>
          <!-- 你的代码生成工具配置 -->
          <skipDependencyResolution>true</skipDependencyResolution>
        </configuration>
      </execution>
    </executions>
  </plugin>
  

  配置后，即使不添加命令行参数，Maven也不会为这个插件的执行做依赖解析。

另外，如果你完全不需要sub-prj的依赖来执行代码生成，也可以暂时把gen-src-prj中对sub-prj的依赖标记为<optional>true</optional>，或者直接注释掉，执行完generate-sources后再恢复，但这种方式不如前两种优雅。

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