Java 17 移除了 JAXB 默认支持，需改用 Jakarta EE 命名空间并切换至兼容插件（如 jaxb2-maven-plugin），同时更新绑定配置、包声明方式及生成路径，确保 XSD 到 Java 类的代码生成正常工作。
java 17 移除了 jaxb 默认支持，需改用 jakarta ee 命名空间并切换至兼容插件（如 `jaxb2-maven-plugin`），同时更新绑定配置、包声明方式及生成路径，确保 xsd 到 java 类的代码生成正常工作。
在从 Java 8 迁移至 Java 17 的过程中，JAXB（Java Architecture for XML Binding）因模块化调整被彻底移出 JDK 核心（java.xml.bind 模块已废弃并删除）。这意味着原先基于 maven-jaxb2-plugin（依赖旧版 javax.* 包）的 XSD 代码生成流程将静默失败——构建成功但无文件输出，根本原因在于插件未适配 Jakarta EE 3.0+ 规范，且未正确声明 Jakarta 依赖。
✅ 推荐解决方案：改用 org.codehaus.mojo:jaxb2-maven-plugin
该插件原生支持 Jakarta EE，并持续维护。以下为完整、可直接集成的 Maven 配置（兼容 Java 17+）：
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>jaxb2-maven-plugin</artifactId>
<version>4.0.0</version> <!-- 推荐使用 4.x 系列，全面支持 Jakarta -->
<executions>
<execution>
<id>xjc</id>
<goals>
<goal>xjc</goal>
</goals>
<configuration>
<!-- XSD 文件位置（建议独立目录，避免混入 resources） -->
<sources>
<source>${project.basedir}/src/main/schema</source>
</sources>
<!-- XJB 绑定文件位置 -->
<xjbSources>
<xjbSource>${project.basedir}/src/main/xjb</xjbSource>
</xjbSources>
<!-- 自动启用 Jakarta 支持（无需手动指定 namespace） -->
<extension>true</extension>
<!-- 生成目录保持默认：target/generated-sources/jaxb（符合 Maven 约定） -->
</configuration>
</execution>
</executions>
<dependencies>
<!-- 显式引入 Jakarta JAXB API 和运行时 -->
<dependency>
<groupId>jakarta.xml.bind</groupId>
<artifactId>jakarta.xml.bind-api</artifactId>
<version>4.0.0</version>
</dependency>
<dependency>
<groupId>org.glassfish.jaxb</groupId>
<artifactId>jaxb-runtime</artifactId>
<version>4.0.4</version>
</dependency>
</dependencies>
</plugin>? 关键实践建议：
-
路径分离：将
.xsd和.xjb文件移至src/main/schema/和src/main/xjb/，而非src/main/resources/META-INF/xsd/。前者仅用于编译期代码生成，不应打包进 JAR；后者若误入resources，会导致 schema 被冗余包含，增加 JAR 体积且可能引发运行时冲突。 -
包声明应置于 XJB 中（非 POM）：
在src/main/xjb/fe2_flux_generique.xjb中使用 schema-scoped bindings，清晰解耦配置与构建逻辑：
<?xml version="1.0" encoding="UTF-8"?>
<jxb:bindings
xmlns:jxb="https://jakarta.ee/xml/ns/jaxb"
version="3.0"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- 绑定到具体 XSD 文件 -->
<jxb:bindings schemaLocation="../schema/fe2_flux_generique.xsd" node="/xsd:schema">
<jxb:schemaBindings>
<jxb:package name="fr.icdc.dei.ddr.fe2.xml.domain"/>
</jxb:schemaBindings>
<jxb:globalBindings>
<jxb:serializable uid="1"/>
<!-- Jakarta 兼容的 DateTime 适配器 -->
<jxb:javaType name="java.time.LocalDateTime"
xmlType="xsd:dateTime"
parseMethod="jakarta.xml.bind.DatatypeConverter.parseDateTime"
printMethod="jakarta.xml.bind.DatatypeConverter.printDateTime"/>
</jxb:globalBindings>
</jxb:bindings>
</jxb:bindings>⚠️ 注意事项：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
-
maven-jaxb2-plugin（org.jvnet.jaxb2.maven2）已停止维护，其低版本（如 0.13.2/0.15.2）无法正确解析 Jakarta 命名空间，即使修改xmlns:jxb也无法解决核心兼容性问题。 - 生成目录请严格使用默认
target/generated-sources/jaxb：Maven 生命周期（如mvn clean）会自动清理该路径；若强行写入src/，需手动.gitignore且易引发 IDE 同步异常。 - 若需运行时 XML 验证，请单独将 XSD 复制到
src/main/resources/并通过SchemaFactory加载——与代码生成完全解耦。
完成上述配置后，执行 mvn generate-sources 即可生成符合 Jakarta EE 3.0 规范的 Java 类，无缝支持 Java 17+ 环境。
立即学习“Java免费学习笔记（深入）”；
