XMLBeans Maven 插件（如 2.x 系列）默认绑定 Java 1.4 编译参数，即使项目全局配置为 Java 8+，插件仍会强制使用过时的 -source 1.4 和 -target 1.4，导致构建失败；根本解法是升级插件至 3.0+ 或迁移到官方推荐的 XmlBeans 5.x + xmlbeans-maven-plugin（org.apache.xmlbeans），并正确配置 JDK 兼容性。

xmlbeans maven 插件（如 2.x 系列）默认绑定 java 1.4 编译参数，即使项目全局配置为 java 8+，插件仍会强制使用过时的 `-source 1.4` 和 `-target 1.4`，导致构建失败；根本解法是升级插件至 3.0+ 或迁移到官方推荐的 xmlbeans 5.x + `xmlbeans-maven-plugin`（org.apache.xmlbeans），并正确配置 jdk 兼容性。

在将遗留项目从 JDK 1.4 迁移至 Java 8、11 或 17 的过程中，开发者常遇到 xmlbeans-maven-plugin 报错：

error: Source option 1.4 is no longer supported. Use 6 or later.
error: Target option 1.4 is no longer supported. Use 1.6 or later.

尽管 mvn help:effective-pom 显示 和 均为 1.8，且 maven-compiler-plugin 配置正确，但错误仍源自 XmlBeans 插件自身硬编码的编译选项——尤其是 xmlbeans-maven-plugin 2.x 版本（如 2.3.3）基于旧版 XmlBeans 构建，其内部调用的 javac 命令未继承 Maven 全局编译配置，而是固有地指定 -source 1.4 -target 1.4。该行为在 JDK 9+ 中被彻底废弃（JEP 320 移除 Java EE 模块后，编译器严格校验源/目标版本），因此即使本地环境暂可绕过，CI/CD 构建服务器（如 Jenkins）因 JDK 版本更严格而必然失败。

✅ 正确解决方案：三步升级法

1. 替换插件坐标与版本（关键！）

旧插件 org.codehaus.mojo:xmlbeans-maven-plugin（2.x）已停止维护，且不支持 Java 8+。必须迁移到 Apache 官方维护的插件：

<plugin><groupid>org.apache.xmlbeans</groupid><artifactid>xmlbeans-maven-plugin</artifactid><version>5.3.0</version><!-- 推荐使用最新稳定版 --><executions><execution><phase>generate-sources</phase><goals><goal>compile</goal><!-- 注意：新版 goal 名为 compile，非 xmlbeans --></goals><configuration><schemadirectory>${project.basedir}/src/main/schema</schemadirectory><outputdirectory>${project.build.directory}/generated-sources/xmlbeans</outputdirectory><!-- 显式声明 JDK 兼容性（XMLBeans 5.x 要求 Java 8+） --><javasourceversion>1.8</javasourceversion></configuration></execution></executions></plugin>

⚠️ 注意：xmlbeans-maven-plugin 5.x 是 Apache XMLBeans 5.0.0+ 的官方内置插件（不再由 Codehaus 维护），其 compile goal 原生支持 Java 8–21，且自动适配 Maven 的 maven.compiler.source 属性。

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

2. 补充生成源目录注册（防止编译跳过）

XmlBeans 生成的类默认输出至 target/generated-sources/xmlbeans/，但 Maven 编译器默认不扫描该路径。需通过 build-helper-maven-plugin 注册为额外源根：

<plugin><groupid>org.codehaus.mojo</groupid><artifactid>build-helper-maven-plugin</artifactid><version>3.5.0</version><!-- 使用较新版本以兼容高 JDK --><executions><execution><id>add-source</id><phase>generate-sources</phase><goals><goal>add-source</goal></goals><configuration><sources><source>${project.build.directory}/generated-sources/xmlbeans</source></sources></configuration></execution></executions></plugin>

3. 同步依赖与运行时兼容性

确保 xmlbeans 运行时库版本与插件一致，并规避已知漏洞：

<dependency><groupid>org.apache.xmlbeans</groupid><artifactid>xmlbeans</artifactid><version>5.3.0</version></dependency><!-- 若项目含 log4j，注意 XMLBeans 5.2.2 存在 log4j-api 2.24.1 安全缺陷 --><dependency><groupid>org.apache.logging.log4j</groupid><artifactid>log4j-api</artifactid><version>2.24.2</version><!-- 强制覆盖至安全版本 --><scope>provided</scope></dependency>

? 验证与调试技巧

• 执行 mvn clean generate-sources 后检查 target/generated-sources/xmlbeans/ 是否生成 .java 文件；
• 运行 mvn help:effective-pom | grep -A5 "xmlbeans-maven-plugin" 确认插件配置生效；
• 若仍报错，启用插件调试日志：mvn compile -X | grep -i xmlbeans，定位是否加载了旧版插件 JAR；
• 对于 Java 17+ 项目，禁用 --illegal-access=permit（已废弃），改用模块化白名单或迁移到 Jakarta EE API。

? 总结

XmlBeans 插件的 JDK 不兼容本质是技术债叠加：旧插件架构僵化 + Maven 编译作用域隔离 + JDK 语义演进。解决它不能靠局部参数覆盖（如 1.8 在 2.x 插件中无效），而必须执行版本升级+路径注册+依赖对齐三位一体改造。截至 2026 年，XMLBeans 5.3.0 是生产环境唯一推荐组合，全面支持 Java 8–21，并修复了 XXE（CVE-2021-23926）等关键安全问题。迁移后，不仅消除编译错误，更获得类型系统稳定性提升与长期维护保障。