Microprofile RestClient中x-www-form-urlencoded参数顺序如何指定？

猜想验证 #

对，你的猜想完全正确。org.jboss.resteasy.client.jaxrs.internal.proxy.processors.FormProcessor 内部确实使用了无顺序的HashMap存储表单参数，序列化表单时会随机输出参数顺序，这就是你遇到问题的根源。

可行解决方案 #

方案1：自定义请求拦截器重写参数顺序（无侵入现有接口定义） #

不需要修改你已经写好的Service接口和Input类，只要新增一个绑定到该客户端的请求拦截器，手动重构固定顺序的表单参数即可：
拦截器代码示例：

import org.jboss.resteasy.specimpl.MultivaluedMapImpl;
import javax.ws.rs.client.ClientRequestContext;
import javax.ws.rs.client.ClientRequestFilter;
import javax.ws.rs.core.Form;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.MultivaluedMap;
import javax.ws.rs.ext.Provider;
import java.io.IOException;

@Provider
public class FixedOrderFormFilter implements ClientRequestFilter {
    @Override
    public void filter(ClientRequestContext requestContext) throws IOException {
        // 仅处理表单提交请求
        if (!MediaType.APPLICATION_FORM_URLENCODED_TYPE.equals(requestContext.getMediaType())) {
            return;
        }
        Object entity = requestContext.getEntity();
        if (entity instanceof Form) {
            Form originalForm = (Form) entity;
            // 使用保持插入顺序的MultivaluedMap重写参数顺序
            MultivaluedMap<String, String> fixedOrderParams = new MultivaluedMapImpl<>();
            // 按业务要求的顺序添加参数
            fixedOrderParams.add("title", originalForm.asMap().getFirst("title"));
            fixedOrderParams.add("description", originalForm.asMap().getFirst("description"));
            requestContext.setEntity(new Form(fixedOrderParams));
        }
    }
}

然后在你的Service接口上注册这个拦截器即可，原有方法不用修改：

@RegisterRestClient(configKey = "service")
@RegisterProvider(FixedOrderFormFilter.class)
public interface Service {
  @POST
  @Path("Invoice")
  @Produces(MediaType.APPLICATION_JSON)
  @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
  Response request(@QueryParam("instance") String instance, @BeanParam Input input);
}

方案2：手动拼接表单字符串提交（最稳妥，完全可控） #

直接修改接口入参为字符串类型，自己按要求的顺序拼接编码后的表单参数，完全规避框架的自动序列化逻辑：
修改后的接口定义：

@RegisterRestClient(configKey = "service")
public interface Service {
  @POST
  @Path("Invoice")
  @Produces(MediaType.APPLICATION_JSON)
  @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
  Response request(@QueryParam("instance") String instance, String formBody);
}

调用时手动拼接编码后的参数：

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

// 所有参数需要先做URL编码，避免特殊字符导致解析错误
String title = URLEncoder.encode("Test", StandardCharsets.UTF_8);
String description = URLEncoder.encode("Testdescription", StandardCharsets.UTF_8);
String formBody = "title=" + title + "&description=" + description;
// 调用接口
service.request("your-instance", formBody);

之前尝试方案失败原因说明 #

你之前用@BeanParam接收Form或者Entity<Form>的用法不符合规范，@BeanParam的作用是将请求的多个参数（查询参数、表单参数、路径参数等）绑定到Java对象的属性上，不是用来传递整个表单实体的，所以服务器收不到数据是正常现象。

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