Swagger Codegen未正确注解文件请求体参数求助

问题根源 #

1. 注解适配错误：你使用的jaxrs-resteasy-eap模板生成了Swagger的@Parameter注解标注请求体参数，但RestEasy（遵循Jakarta JAX-RS规范）默认通过无注解参数（或部分实现支持的@RequestBody）识别请求体，@Parameter仅用于API文档生成，无法让RestEasy正确解析请求体。
2. 参数类型生成错误：Swagger定义的string/binary本应生成InputStream、byte[]这类适配二进制流的Java类型，但模板生成了Object，RestEasy没有默认的消息体读取器能将application/octet-stream转换为Object，直接触发报错。

解决步骤 #

1. 更换Codegen模板（优先推荐）

jaxrs-resteasy-eap是针对JBoss EAP的旧模板，Quarkus环境下更适配jaxrs-resteasy或jaxrs-resteasy-quarkus模板（需确认你的codegen版本支持）：
修改Maven插件的<language>配置：

<language>jaxrs-resteasy</language>

或（若版本支持）：

<language>jaxrs-resteasy-quarkus</language>

2. 调整Codegen配置参数

在插件的<configOptions>中添加以下参数，强制模板生成符合规范的请求体注解和类型：

<configOptions>
    <!-- 原有配置保留 -->
    <useRequestBodyForPrimitiveTypes>true</useRequestBodyForPrimitiveTypes>
    <useJakartaEe>true</useJakartaEe> <!-- 确保适配Jakarta规范 -->
</configOptions>

3. 优化Swagger定义（辅助）

在swagger.yml中明确指定生成的Java类型，避免模板生成Object：

requestBody:
  required: true
  content:
    application/octet-stream:
      schema:
        type: string
        format: binary
        x-java-type: java.io.InputStream # 强制生成InputStream类型

4. 手动修正生成代码（临时方案）

如果上述配置无法生效，直接修改生成的接口方法：

@POST
@Path("/blah")
@Consumes({ "application/octet-stream" })
@Produces({ "application/json" })
// 其他注解保留
Response blah(InputStream body, @Context SecurityContext securityContext);

• 移除@Parameter注解（或保留不影响，核心是参数类型调整）
• 将参数类型从Object改为InputStream或byte[]，RestEasy有默认的消息体读取器处理这两种类型与application/octet-stream的转换。

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