使用JAXB与XJC Maven插件生成Java类失败求助

我来帮你梳理下可能的问题点和对应的解决方案，结合你的pom配置和使用场景，这些是最常见的排查方向：

可能的原因及修复方案 #

1. 插件未绑定到正确的构建生命周期阶段 #

默认情况下，jaxb2-maven-plugin的xjc目标不会自动绑定到Maven的构建阶段，这意味着你执行mvn clean install时，可能根本没触发代码生成逻辑。你需要在<execution>块中明确指定绑定的阶段，推荐绑定到generate-sources（这是Maven源码生成的标准阶段）：

<execution>
    <id>xjc</id>
    <phase>generate-sources</phase> <!-- 添加这一行，绑定到源码生成阶段 -->
    <goals>
        <goal>xjc</goal>
    </goals>
</execution>

2. 输出目录不符合预期（或未配置） #

你的配置只指定了packageName，但插件默认会把生成的类放到target/generated-sources/jaxb目录下，而不是直接写入src/main/java。如果你期望输出到src/main/java/com/example/message，需要显式配置<outputDirectory>：

<configuration>
    <packageName>com.example.message</packageName>
    <sources>
        <source>src/main/resources/static/xsd/example.xsd</source>
    </sources>
    <outputDirectory>src/main/java</outputDirectory> <!-- 指定输出目录 -->
    <source>1.7</source> <!-- 适配你的Java版本 -->
    <target>1.7</target>
</configuration>

小提示：直接写入src/main/java可能会带来版本控制问题（生成的代码通常不建议提交到仓库），更推荐让插件生成到target/generated-sources/jaxb，再通过配置让Maven识别这个目录为源码目录，编译时自动包含这些类：

<configuration>
    <packageName>com.example.message</packageName>
    <sources>
        <source>src/main/resources/static/xsd/example.xsd</source>
    </sources>
    <generatedSourcesDirectory>target/generated-sources/jaxb</generatedSourcesDirectory>
    <source>1.7</source>
    <target>1.7</target>
</configuration>

3. XSD文件本身存在有效性问题 #

先确认example.xsd是一个合法的XML Schema文件：

• 用IDE（比如IntelliJ IDEA、Eclipse）打开XSD，检查是否有语法错误或红线提示
• 可以用xmllint等工具在命令行验证XSD的有效性

如果XSD存在语法错误，插件可能会静默失败，不会生成任何类文件。

4. 插件版本与Java/Spring Boot版本不兼容 #

你使用的是Java 1.7和Spring Boot 1.5.13，而jaxb2-maven-plugin 2.3.1对Java 7的支持并不友好。建议尝试降级插件版本到2.2（这个版本和Java 7兼容性更好）：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>jaxb2-maven-plugin</artifactId>
    <version>2.2</version> <!-- 修改为兼容Java 7的版本 -->
    <!-- 其余配置保持不变 -->
</plugin>

验证步骤 #

1. 先单独执行源码生成命令，快速验证是否有输出：

   mvn clean generate-sources
   

2. 如果还是没有生成，查看Maven的详细日志排查错误：

   mvn clean install -X
   

   在日志中搜索jaxb2-maven-plugin或xjc相关条目，看是否有找不到XSD文件、解析错误等提示。

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