如何在Quarkus中实现FORM_URL_ENCODED转POJO？

Quarkus支持将application/x-www-form-urlencoded请求直接绑定到POJO，你遇到的415错误是因为使用方式或配置存在问题，以下是正确的实现方案及问题排查点：

正确的POJO定义 #

确保POJO的每个表单字段都添加@RestForm注解，同时保证类有默认构造函数（未自定义构造函数时Java会自动生成，无需手动编写）：

import io.quarkus.resteasy.reactive.RestForm;

public class FormStuff {
    @RestForm
    public String title;

    @RestForm
    public String description;

    // 其他表单字段同理添加@RestForm注解
}

正确的资源方法实现 #

直接将POJO作为方法参数传入，无需额外注解，同时确保@Consumes指定正确的媒体类型：

import jakarta.ws.rs.Consumes;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.Path;
import org.jboss.logging.Logger;
import static jakarta.ws.rs.core.MediaType.APPLICATION_FORM_URLENCODED;

@Path("/submit-form")
public class FormResource {
    private static final Logger log = Logger.getLogger(FormResource.class);

    @POST
    @Consumes(APPLICATION_FORM_URLENCODED)
    public void save(FormStuff stuff) {
        log.info("Got Stuff! {}", stuff);
    }
}

415错误的常见排查点 #

• 请求Content-Type不匹配：确认前端发送请求时，设置的Content-Type严格为application/x-www-form-urlencoded，而非multipart/form-data或其他类型。
• POJO缺少默认构造函数：如果POJO定义了带参构造函数，必须显式添加无参构造函数，否则Quarkus无法实例化该类。
• 字段访问权限问题：若字段设为private，需提供对应的getter/setter方法；使用public字段则无需额外处理。

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