Java17 Gradle项目测试报错：javax/xml/bind/annotation/XmlElement缺失

问题本质 #

Java 9起模块化重构后，JAXB（原Java EE组件）被移出JDK默认类路径，Java17彻底移除了这套API。你的代码里没直接引用javax包，但依赖的第三方库（比如WireMock或其依赖的组件）大概率还在使用旧版javax.xml.bind相关类，导致测试运行时找不到类。

解决方案 #

1. 添加兼容javax的JAXB测试依赖 #

如果依赖的库还没迁移到Jakarta生态，直接引入javax版本的JAXB全套依赖（仅在测试阶段生效）：

testImplementation 'javax.xml.bind:jaxb-api:2.3.1'
testRuntimeOnly 'com.sun.xml.bind:jaxb-core:2.3.0.1'
testRuntimeOnly 'com.sun.xml.bind:jaxb-impl:2.3.3'
testRuntimeOnly 'javax.activation:activation:1.1.1'

2. 升级WireMock到Java17兼容版本 #

WireMock从2.35.0版本开始正式支持Java17，若你用的是旧版，升级到稳定版：

// 标准JRE8+版本（兼容Java17）
testImplementation 'com.github.tomakehurst:wiremock-jre8:2.35.0'
// 若依赖Jakarta API，用这个分支
testImplementation 'com.github.tomakehurst:wiremock-jre8-jakarta:2.35.0'

升级后，WireMock的依赖链会自动适配Java17，减少对旧javax API的依赖。

3. 临时应急：通过JVM参数强制引入兼容模块（不推荐长期使用） #

在Gradle测试任务中添加JVM参数，强制启用JAXB的兼容模块：

test {
    jvmArgs '--add-modules', 'java.xml.bind'
}

这个方法只是临时绕过问题，长期来看还是建议升级依赖或添加正确的JAXB依赖。

排查建议 #

• 执行gradle dependencies查看测试依赖树，定位到底是哪个库引入了javax.xml.bind相关依赖，针对性处理。
• 确认所有测试依赖（比如JSON序列化库、HTTP客户端等）的版本是否支持Java17，旧版本往往存在这类兼容性问题。

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