Maven-MVND构建顺序问题：注解处理器依赖未被正确识别

问题背景

在多模块Maven项目中，当使用Maven Daemon(mvnd)进行构建时，可能会遇到模块构建顺序不正确的问题。具体表现为：一个使用了注解处理器(annotation processor)的模块可能在注解处理器模块本身完成构建之前就开始编译。

问题复现场景

假设我们有一个典型的多模块项目结构：

pom.xml
-- annotation-processor (注解处理器模块)
-- example-use (使用注解处理器的模块)

在example-use模块的pom.xml中，通常会这样配置注解处理器路径：

<annotationProcessorPaths>
    <path>
        <groupId>thegroup</groupId>
        <artifactId>annotation-processor</artifactId>
        <version>1.0-SNAPSHOT</version>
    </path>
</annotationProcessorPaths>

根本原因分析

这个问题实际上源于Maven核心机制的一个限制，而非mvnd特有的缺陷。Maven核心在构建项目依赖图时，无法理解插件配置中引用的构件与项目模块之间的关系。具体来说：

1. Maven无法识别annotationProcessorPaths配置中引用的构件实际上是当前反应堆(reactor)中的另一个模块
2. 因此，Maven不会将这些引用作为模块间依赖关系来处理，导致构建顺序可能不正确
3. 这个问题在标准Maven(mvn)中也存在，但在mvnd中可能表现得更加明显

解决方案

1. 显式声明模块依赖

最可靠的解决方案是在example-use模块中显式声明对annotation-processor模块的依赖，即使代码本身并不需要这个依赖：

<dependencies>
    <dependency>
        <groupId>thegroup</groupId>
        <artifactId>annotation-processor</artifactId>
        <version>1.0-SNAPSHOT</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

使用provided作用域可以确保：

• 依赖项不会被打入最终构件
• 但能保证正确的构建顺序

2. 未来解决方案展望

在Maven 4.0中，将引入NONE作用域，这将是一个更优雅的解决方案：

<scope>none</scope>

none作用域专门用于这种情况：仅需要影响构建顺序，而不需要实际的依赖关系。

最佳实践建议

1. 对于注解处理器模块：始终在使用它们的模块中显式声明依赖
2. 作用域选择：
   • 当前使用provided
   • 未来Maven 4.0+可使用none
3. 构建工具选择：无论是使用mvn还是mvnd，都应遵循相同的依赖声明原则

总结

Maven构建系统中的模块依赖关系需要显式声明，特别是在涉及注解处理器等编译时工具时。虽然annotationProcessorPaths配置可以指定处理器路径，但它不会影响模块构建顺序。通过添加显式依赖(即使是provided作用域的)，可以确保正确的构建顺序，这是当前最可靠的解决方案。随着Maven 4.0的发布，none作用域将为此类场景提供更精确的控制能力。