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"?><bindings xmlns:jxb="https://jakarta.ee/xml/ns/jaxb" version="3.0" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><!-- 绑定到具体 XSD 文件 --><bindings schemalocation="../schema/fe2_flux_generique.xsd" node="/xsd:schema"><schemabindings><package name="fr.icdc.dei.ddr.fe2.xml.domain"></package></schemabindings><globalbindings><serializable uid="1"></serializable><!-- Jakarta 兼容的 DateTime 适配器 --><javatype name="java.time.LocalDateTime" xmltype="xsd:dateTime" parsemethod="jakarta.xml.bind.DatatypeConverter.parseDateTime" printmethod="jakarta.xml.bind.DatatypeConverter.printDateTime"></javatype></globalbindings></bindings></bindings>
⚠️ 注意事项：
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免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
