升级Quarkus2到3用quarkus-rest时，ResteasyReactiveJaxbProcessor为何拒绝简单集合？

问题根源 #

quarkus-rest基于Resteasy Reactive实现，它对JAXB的集合/数组处理严格遵循JAXB规范——直接返回List<String>这类没有根元素的集合时，JAXB无法完成序列化/反序列化。而你之前用的quarkus-rest-classic（原quarkus-resteasy）做了隐式包装的兼容处理，所以能正常运行。

无需编写包装类的兼容方案 #

1. 全局开启集合自动包装 #

在application.properties中添加以下配置，让Resteasy Reactive自动为集合生成隐式根元素，和classic行为对齐：

quarkus.resteasy-reactive.jaxb.allow-collections-without-wrapper=true

2. 为单个API指定包装注解 #

如果不想全局开启，可在需要的方法或参数上添加JAXB注解，指定根元素和子元素名称：

import jakarta.xml.bind.annotation.XmlElement;
import jakarta.xml.bind.annotation.XmlWrapper;

@XmlWrapper(name = "serviceNames")
@XmlElement(name = "name")
public List<String> getServiceNames(
    @XmlWrapper(name = "systems") 
    @XmlElement(name = "system") List<String> systems
) {
    // 业务逻辑实现
}

JAXB会根据注解自动生成合法的XML结构，无需额外包装类。

3. 优先使用JSON序列化（若API以JSON为主） #

如果你的接口主要用JSON而非XML，可配置优先使用Jackson处理序列化，避开JAXB的严格检查：

• 在application.properties中添加：

quarkus.resteasy-reactive.preferred-media-type=application/json

• 确保依赖中包含Jackson支持（quarkus-rest默认已集成，也可显式声明）：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-rest-jackson</artifactId>
</dependency>

这样集合类型会被Jackson正常序列化，不会触发JAXB的报错。

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