Spring Boot中如何读取target/generated-sources下的Java文件？

我之前也碰到过一模一样的问题，折腾了好一阵子才搞定，咱们一步步来排查和解决：

1. 先确认build-helper-maven-plugin的配置是否精准 #

这是最容易踩坑的地方：很多人会只写target/generated-sources，但maven-jaxb2-plugin默认会在这个目录下生成jaxb子目录，所以你的源目录配置必须精确到子目录，而且要绑定到正确的生命周期阶段。

正确的配置示例：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>build-helper-maven-plugin</artifactId>
    <version>3.3.0</version> <!-- 建议用最新稳定版 -->
    <executions>
        <execution>
            <id>add-jaxb-generated-sources</id>
            <phase>generate-sources</phase> <!-- 关键：必须在代码生成后、编译前执行 -->
            <goals>
                <goal>add-source</goal>
            </goals>
            <configuration>
                <sources>
                    <!-- 精确到jaxb生成的实际目录 -->
                    <source>${project.build.directory}/generated-sources/jaxb</source>
                </sources>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 验证maven-jaxb2-plugin的输出目录 #

确保JAXB插件确实把文件生成到了你指定的目录，建议显式配置输出目录避免歧义：

<plugin>
    <groupId>org.jvnet.jaxb2.maven2</groupId>
    <artifactId>maven-jaxb2-plugin</artifactId>
    <version>0.14.0</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <!-- 显式指定输出目录，和build-helper里的路径保持一致 -->
                <outputDirectory>${project.build.directory}/generated-sources/jaxb</outputDirectory>
                <!-- 其他配置（如XSD文件路径）... -->
            </configuration>
        </execution>
    </executions>
</plugin>

3. 检查插件执行顺序是否正确 #

Maven是按生命周期阶段执行插件的，必须保证maven-jaxb2-plugin先完成代码生成，再由build-helper-maven-plugin添加源目录。

你可以通过执行mvn clean compile -X查看详细日志，搜索generate-sources和add-source相关的日志，确认顺序是：JAXB生成文件 → build-helper添加源目录 → 编译代码。如果顺序反了，那肯定读不到文件。

4. IDE同步问题（如果用IDEA/Eclipse） #

有时候IDE不会自动同步Maven的源目录配置：

• IDEA：点击Maven面板的「刷新」按钮，或者执行mvn idea:idea（旧版IDEA），然后重新导入项目。
• Eclipse：执行mvn eclipse:eclipse，然后刷新项目。

5. 其他插件的排查 #

• spring-boot-maven-plugin：默认不会影响源目录配置，除非你自定义了<sources>节点，检查一下有没有排除生成目录的配置。
• sonar-maven-plugin：如果Sonar分析时看不到文件，检查sonar.sources配置是否包含target/generated-sources/jaxb，默认情况下Sonar会扫描所有Maven源目录，但如果手动设置了sonar.sources就需要显式加上。
• maven-surefire-plugin：如果是测试代码里读不到生成的文件，需要用build-helper的add-test-source目标把生成目录添加为测试源目录。

6. 清理Maven缓存 #

最后试试强制清理缓存，避免旧产物干扰：

mvn clean install -U

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