Quarkus 3.9接口返回HTTP 201响应码失败问题求助

问题核心原因 #

Quarkus 3.x默认采用Reactive RESTEasy（resteasy-reactive）栈，但OpenAPI Generator默认生成的代码可能适配传统RESTEasy（resteasy-jaxrs）的注解逻辑，导致@ResponseStatus(201)注解失效；同时若依赖冲突，会引发ResteasyProviderFactoryImpl与RuntimeDelegateImpl的类型转换错误。

具体解决步骤 #

1. 调整OpenAPI Generator适配Reactive栈 #

修改POM中openapi-generator-maven-plugin的配置，指定使用quarkus-reactive模板，确保生成的代码适配Quarkus Reactive环境：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>6.6.0</version> <!-- 使用最新稳定版本 -->
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
                <generatorName>java</generatorName>
                <library>quarkus-reactive</library> <!-- 关键配置，指定Reactive模板 -->
                <configOptions>
                    <interfaceOnly>true</interfaceOnly>
                    <useQuarkus>true</useQuarkus>
                    <sourceFolder>src/main/java</sourceFolder>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 修复201响应码不生效问题 #

方案一：替换为Quarkus专属@Status注解

将生成接口中的@ResponseStatus(201)替换为Quarkus原生的@io.quarkus.runtime.annotations.Status注解，该注解在Reactive栈下能正确生效：

@POST
@Path("/game/init")
@Status(201) // 替换原@ResponseStatus(201)
void initGame();

实现类无需修改返回类型，保持原有逻辑即可。

方案二：使用Reactive版Response返回

在实现类中直接返回jakarta.ws.rs.core.Response，确保依赖的是Reactive栈的API：

@Override
public Response initGame() {
    // 执行游戏初始化逻辑
    return Response.status(Response.Status.CREATED).build();
}

3. 清理POM中的依赖冲突 #

检查并移除所有传统RESTEasy相关依赖（如org.jboss.resteasy:resteasy-*），仅保留Quarkus Reactive栈的REST依赖：

<dependencies>
    <!-- Reactive REST核心依赖 -->
    <dependency>
        <groupId>io.quarkus</groupId>
        <artifactId>quarkus-resteasy-reactive</artifactId>
    </dependency>
    <!-- JSON序列化依赖（按需添加） -->
    <dependency>
        <groupId>io.quarkus</groupId>
        <artifactId>quarkus-resteasy-reactive-jackson</artifactId>
    </dependency>
</dependencies>

4. 验证结果 #

启动Quarkus应用后，通过curl或Postman调用/game/init接口，确认响应状态码为201，且无类型转换异常抛出。

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