首次执行mvn compile无法找到生成源码的配置解决方案咨询

首次编译失败的核心原因有两个：

• 多余的build-helper-maven-plugin配置干扰了编译流程：配置在generate-sources阶段就把空的target/generated-sources/annotations目录加入源码根，此时注解处理器还未执行，目录下没有任何生成的类，javac启动时扫描所有源码路径的符号引用，直接判定找不到生成类抛出编译错误。哪怕后续注解处理器在同次编译中生成了对应源码，javac也不会回溯修正已经触发的符号检查错误。
• 实际上maven-compiler-plugin 3.5及以上版本默认就会自动将注解处理器生成的target/generated-sources/annotations目录标记为源码根，不需要手动通过build-helper插件添加。

• 直接删除整个build-helper-maven-plugin的插件配置，包括pluginManagement中和该插件相关的lifecycle映射配置，当前流程完全不需要这个插件参与。
• 调整maven-compiler-plugin的配置，显式声明生成源码路径（可选但推荐，避免不同版本插件的默认行为差异），配置示例如下：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.10.1</version>
    <configuration>
        <!-- 替换成你实际使用的JDK版本 -->
        <source>11</source>
        <target>11</target>
        <!-- 显式指定注解处理器生成源码路径，插件会自动将该路径加入编译列表 -->
        <generatedSourcesDirectory>${project.build.directory}/generated-sources/annotations</generatedSourcesDirectory>
        <annotationProcessorPaths>
            <path>
                <groupId>some-group</groupId>
                <artifactId>some-processor</artifactId>
                <version>${project.version}</version>
            </path>
        </annotationProcessorPaths>
        <!-- 可选：如果你知道注解处理器的全限定类名，显式配置可以跳过SPI扫描，避免处理器发现失败的问题
        <annotationProcessors>
            <annotationProcessor>com.xxx.YourAnnotationProcessor</annotationProcessor>
        </annotationProcessors>
        -->
    </configuration>
</plugin>

• 额外注意：如果some-processor注解处理器和当前业务代码在同一个Maven模块中，上述配置依然会失败——annotationProcessorPaths是从Maven仓库拉取依赖的，首次编译时同版本的处理器还没被安装到本地仓库。这种情况必须将注解处理器拆分为独立的Maven模块，先构建处理器模块，再构建业务模块，这也是Maven官方推荐的注解处理器项目结构。

修改完成后执行mvn clean compile清空旧的target目录再编译，即可一次完成编译，不需要二次执行。

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