Apache Ignite 2.16与Jetty 12.0.13兼容性问题及相关咨询

问题背景 #

使用 Apache Ignite 2.16 时，将 Jetty 从 9.4.53.v20231009 升级至 12.0.13 后启动报错：

java.lang.NoSuchMethodError: 'void org.eclipse.jetty.xml.XmlConfiguration.(java.net.URL)'
at org.apache.ignite.internal.processors.rest.protocols.http.jetty.GridJettyRestProtocol.loadJettyConfiguration(GridJettyRestProtocol.java:278)
at org.apache.ignite.internal.processors.rest.protocols.http.jetty.GridJettyRestProtocol.start(GridJettyRestProtocol.java:129)

原因是 Jetty 12.x 移除了 XmlConfiguration(URL url) 构造方法，但 Ignite 的 GridJettyRestProtocol 仍在调用该方法。Jetty 12.x 替代的构造方法为：

• XmlConfiguration(Resource resource)
• XmlConfiguration(Resource resource, Map<String, Object> idMap, Map<String, String> properties)

当前环境：Jetty 9.4.53.v20231009 + Ignite 2.16（运行正常），目标升级为 Jetty 12.0.13 + Ignite 2.16，JDK 17。

问题解答 #

1. Apache Ignite 2.16 是否官方支持 Jetty 12.0.13？ #

Apache Ignite 2.16 的官方依赖声明中，Jetty 版本为 9.4.53.v20231009，不官方支持 Jetty 12.0.13。Ignite 2.x 系列的 Jetty 适配停留在 9.x 版本，未针对 Jetty 12.x 的 API 变更做兼容处理。

2. 针对 XmlConfiguration(URL url) 缺失问题有哪些可行的解决办法？ #

• 自定义 Jetty 协议扩展：重写 GridJettyRestProtocol 类，将原有的 new XmlConfiguration(url) 替换为 Jetty 12.x 的 API，比如通过 Resource.newResource(url) 构建资源对象后传入新构造方法。编译后替换 Ignite 原有的对应类文件（需注意类加载优先级）。
• 尝试 Jetty 兼容模块：Jetty 12.x 提供了 jetty-ee8 或 jetty-ee9 兼容模块，引入对应兼容包，测试是否能自动适配旧 API 调用（此方法不保证完全兼容，需验证）。
• 降级 Jetty 至维护版本：暂时切换到 Jetty 9.x 的最后维护版本（如 9.4.54.v20240603），直到 Ignite 官方支持 Jetty 12.x 后再升级。
• 修改 Ignite 源码重编译：下载 Ignite 2.16 源码，修改 GridJettyRestProtocol.java 中加载 Jetty 配置的代码，适配 Jetty 12.x 的构造方法，重新打包 Ignite 后使用。

3. 考虑到 Jetty 9.x 已停止维护，Apache Ignite 是否有支持 Jetty 12.x 的计划？ #

Ignite 3.x 系列已经完成 Jetty 12.x 的适配，而 Ignite 2.x 作为维护分支，目前官方暂无明确计划将 Jetty 版本升级至 12.x。如果需要使用 Jetty 12.x，建议迁移至 Ignite 3.x 版本，该版本已对 Jetty 12.x 的 API 变更做了全面兼容。

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