升级必看！REST Assured 4.1.1 JAXB依赖调整全指南-优快云博客

升级必看！REST Assured 4.1.1 JAXB依赖调整全指南

【免费下载链接】rest-assured Java DSL for easy testing of REST services 项目地址: https://gitcode.com/gh_mirrors/re/rest-assured

你是否在升级REST Assured后遭遇过NoClassDefFoundError或ClassNotFoundException？是否困惑于JAXB相关依赖突然失效？本文将详解REST Assured 4.1.1版本中JAXB API的关键升级，帮你3分钟解决依赖冲突，确保项目平稳过渡。

版本变更核心要点

REST Assured 4.1.1对JAXB（Java Architecture for XML Binding，Java XML绑定架构）相关依赖进行了重要升级，具体变更如下：

Changelog 4.1.1 (2019-09-06)
---------------------------
* Upgraded jaxb-api from 2.2.12 to 2.3.1
* Upgraded jaxb-osgi from 2.2.10 to 2.3.0.1

—— changelog.txt

这一变更解决了旧版本JAXB API与Java 9+模块系统的兼容性问题，但也可能导致现有项目出现依赖冲突。

依赖调整具体内容

在REST Assured的核心POM文件中，JAXB相关依赖定义如下：

<!-- Jakarta EE 8 -->
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <optional>true</optional>
</dependency>
<!-- Jakarta EE 9 -->
<dependency>
    <groupId>jakarta.xml.bind</groupId>
    <artifactId>jakarta.xml.bind-api</artifactId>
    <optional>true</optional>
</dependency>
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <optional>true</optional>
</dependency>

—— rest-assured/pom.xml

关键变化说明

依赖项	旧版本	新版本	说明
jaxb-api	2.2.12	2.3.1	升级至JAXB 2.3.1，支持Java 9+模块系统
jaxb-osgi	2.2.10	2.3.0.1	OSGi环境专用JAXB实现，解决类加载问题

升级后可能遇到的问题及解决方案

问题1：ClassNotFoundException: javax.xml.bind.JAXBException

原因：JAXB API在Java 9+中被标记为可选模块，默认不包含在运行时。

解决方案：在项目POM中显式添加JAXB依赖：

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.3</version>
</dependency>

问题2：模块系统错误 "Package javax.xml.bind is not accessible"

原因：Java 9+模块系统限制了对JAXB API的访问。

解决方案：在module-info.java中添加：

requires javax.xml.bind;

或使用--add-modules java.xml.bind启动参数。

最佳实践与建议

明确指定依赖版本：在项目POM中显式声明JAXB依赖版本，避免传递依赖冲突。
使用Maven依赖管理：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
            <version>2.3.1</version>
        </dependency>
    </dependencies>
</dependencyManagement>

针对不同Java版本的配置：

Java 8及以下：无需额外配置
Java 9-10：添加jaxb-api和jaxb-impl依赖
Java 11+：除添加依赖外，可能需要添加--add-modules启动参数

总结与展望

REST Assured 4.1.1的JAXB依赖升级虽然带来了短暂的适配成本，但解决了长期存在的兼容性问题，特别是对Java 9+的支持。建议所有用户尽快升级，并检查项目中的JAXB依赖配置。

未来版本中，REST Assured可能会进一步迁移到Jakarta EE API（jakarta.xml.bind），完全支持Java EE到Jakarta EE的过渡。

升级必看！REST Assured 4.1.1 JAXB依赖调整全指南