如何让Java HttpPost请求的请求体不包含前缀URL内容

根因说明 #

你给出的标准HttpClient POST表单提交逻辑本身不会主动将请求URL拼接进请求体，出现该异常的常见原因有三类：

• this.cmAddress.toURI()返回的实际URI已经携带了查询参数，异常逻辑下误将完整带参URI写入了请求体
• queryParams集合中存在空键、值为完整URL的异常条目，构造表单实体时被拼接在最前面
• HttpClient配置了自定义拦截器/装饰器，强制将URI内容写入了请求体

修复步骤 #

1. 清理请求URI，确保仅保留纯接口地址 #

构造HttpPost时主动截断URI上的查询参数，避免地址携带多余参数：

// 从原有地址中提取协议、host、端口、路径，丢弃查询串等多余内容
URI pureApiUri = new URI(
    cmAddress.getScheme(),
    null,
    cmAddress.getHost(),
    cmAddress.getPort(),
    cmAddress.getPath(),
    null,
    null
);
HttpPost post = new HttpPost(pureApiUri);

2. 校验过滤表单参数，排除异常条目 #

构造参数列表时过滤无效、异常的键值对：

List<NameValuePair> params = new ArrayList<>(queryParams.size());
for (Map.Entry<String, String> entry : queryParams.entrySet()) {
    String key = entry.getKey() == null ? "" : entry.getKey().trim();
    String value = entry.getValue() == null ? "" : entry.getValue().trim();
    // 跳过空键、值为HTTP/HTTPS开头的异常参数
    if (key.isEmpty() || value.startsWith("http")) {
        continue;
    }
    params.add(new BasicNameValuePair(key, value));
}
post.setEntity(new UrlEncodedFormEntity(params, "UTF-8"));
post.setHeader(HttpHeaders.CONTENT_TYPE, "application/x-www-form-urlencoded");

3. 可选：打印校验请求体内容 #

调整后可以临时加日志验证请求体格式是否符合要求，注意打印后需重新设置Entity避免被消费：

// 临时调试用，生产环境可删除
String formBody = EntityUtils.toString(post.getEntity());
System.out.println("实际请求体：" + formBody);
// 重新设置Entity，避免前面的消费导致请求无内容
post.setEntity(new UrlEncodedFormEntity(params, "UTF-8"));

CloseableHttpResponse response = httpClient.execute(post);

如果完成上述调整后问题依然存在，排查HttpClient的全局拦截器配置，确认没有自定义逻辑向请求体中拼接URI内容。

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