如何使用OkHttp在POST请求中同时传递查询参数与请求体

我当前使用的Java代码如下，通过URL传递参数：

RequestBody jsonRequestBody = RequestBody.create(mediaType, jsonBody.toString());             
Request request = new Request.Builder()
        .url("http://x.x.x.x:8080/v1/m?identifier=" + identifier)
        .addHeader("claim", claim)
        .post(jsonRequestBody)
        .build();

Response response = client.newCall(request).execute();

我的Spring Boot接口同时包含@RequestBody Class obj和@RequestParam identifier两个参数，其中请求体内容会自动序列化为obj对象。我希望将查询参数与请求体分开传递，不想把查询参数放入请求体中，但使用OkHttp一直未能解决这个问题，恳请帮助。

你的代码写法本身是符合需求的，OkHttp完全支持POST请求同时携带URL查询参数和JSON请求体。如果接口无法正确接收identifier参数，可从以下几个方向排查解决：

1. 规范URL构建，避免编码问题 #

直接拼接字符串容易因identifier包含特殊字符（如空格、&、=等）导致参数解析失败，建议使用HttpUrl工具类构建URL，自动处理编码：

HttpUrl url = new HttpUrl.Builder()
        .scheme("http")
        .host("x.x.x.x")
        .port(8080)
        .addPathSegments("v1/m")
        .addQueryParameter("identifier", identifier)
        .build();

RequestBody jsonRequestBody = RequestBody.create(mediaType, jsonBody.toString());             
Request request = new Request.Builder()
        .url(url)
        .addHeader("claim", claim)
        .post(jsonRequestBody)
        .build();

Response response = client.newCall(request).execute();

2. 检查Spring Boot接口定义 #

确保接口的@RequestParam参数配置正确：

• 如果identifier是必填参数，可明确标注required = true（默认即为true）；
• 如果参数名与URL中的不一致，需通过value属性指定映射关系，例如@RequestParam(value = "identifier") String id；

示例接口代码：

@PostMapping("/v1/m")
public ResponseEntity<?> yourApiMethod(
        @RequestBody Class obj,
        @RequestParam String identifier) {
    // 业务逻辑实现
}

3. 确认请求头Content-Type设置 #

确保请求的Content-Type为application/json，否则Spring Boot无法正确解析JSON请求体：

MediaType mediaType = MediaType.parse("application/json; charset=utf-8");
RequestBody jsonRequestBody = RequestBody.create(mediaType, jsonBody.toString());

4. 日志排查参数传递情况 #

如果以上配置都没问题，可通过日志确认参数传递状态：

• OkHttp端打印完整请求URL和请求体，确认参数已正确拼接；
• Spring Boot端开启Web日志，查看参数解析过程，在application.yml中添加配置：

logging:
  level:
    org.springframework.web: DEBUG

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