RestTemplate发送Post请求报错:414 URI Too Long问题及解决

 更新时间:2026年01月13日 10:56:23   作者:五月天的尾巴  
本文介绍了使用RestTemplate发送POST请求时遇到414 URITooLong错误的原因,并提供了几种解决方法,如使用LinkedMultiValueMap处理表单数据或将参数拼接到URI上,同时,强调了不要使用GET方法发送POST请求,并避免在URL中拼接参数

一、报错背景

使用RestTemplate发送http Post请求时,返回了一个报错 414 URI Too Long。

因为服务端是Post请求并用@RequestParam进行接收,所以我将参数都拼接在URL后面,如http://localhost:80/add?name=1&age=2 ,导致URL过长。

报错代码

RestTemplate restTemplate = new RestTemplate();

// 创建请求体
List<NameValuePair> params = new ArraysList<>();
params.add(new BasicNameValuePair("name","张三"));
params.add(new BasicNameValuePair("age","15"));
//....... 设置大量内容

// 设置请求头
HttpHeaders headers = new HttpHeaders();

// 创建HttpEntity对象
HttpEntity<String> httpEntity = new HttpEntity<>(null,headers);
URI uri = URI.create(url);
if(!CollectionUtils.isEmpty(params)){
	String param = URLEncodedUtils.format(params, StandardCharsets.UTF_8);
	uri = URI.create(url+"?"+param);
}
// 发送POST请求
String response = restTemplate.exchange(uri, HttpMethod.POST, httpEntity , String.class).getBody();

报错内容

org.springframework.web.client.HttpClientErrorException : 414 URI Too Long:"<h1>Bad Message 414</h1><pre>reason: URI Too Long</pre>"​

二、问题分析:414 URI Too Long

HTTP状态码414表示客户端发送的请求URI过长,服务器拒绝处理。使用RestTemplate发送POST请求时出现该错误,通常是因为请求参数被错误地附加到URL中而非请求体中,导致URL超过服务器限制长度。

HTTP协议规定,请求的URI长度不能超过2083个字符。这是因为在HTTP/1.1协议中,请求行和请求头字段的总长度被限制在8192字节(不包括CRLF)。

2.1、常见原因

  • 参数误放在URL中:POST请求本应将参数放在请求体(Body)中,但实际被拼接到了URL末尾。
  • RestTemplate配置问题:未正确配置HttpMessageConverter,导致参数无法序列化到请求体。
  • URL编码问题:参数中包含特殊字符未编码,进一步增加URL长度。

三、解决方法

本文报错是由于发送Post请求时,服务端的接口用的是@RequestParam接收参数,而不是json,所以以下整理几种方法发送@RequestParam入参类型的POST请求。

3.1、使用 LinkedMultiValueMap 处理表单数据(推荐)

本方法是将请求参数放到请求体中,不占用URI的长度,所以就算请求体比较大,也不会报414 URI Too Long的错误。

示例:

RestTemplate restTemplate = new RestTemplate();

HttpHeaders headers = new HttpHeaders();
// 设置内容类型为 application/x-www-form-urlencoded
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);

// 使用 MultiValueMap 存放表单数据
MultiValueMap<String, String> formData = new LinkedMultiValueMap<>();
formData.add("key1", "value1");
formData.add("key2", "value2");
// ... 可以添加很多对,只要不超出服务器对Body大小的通常宽松限制

HttpEntity<MultiValueMap<String, String>> requestEntity = new HttpEntity<>(formData, headers);

ResponseEntity<String> response = restTemplate.postForEntity(
    "http://your-api-endpoint.com/api/resource", 
    requestEntity, 
    String.class
);

3.2、将参数拼接到URI上

如果你只是想在URL中包含查询参数,可以使用Uri来构建URL。

RestTemplate restTemplate = new RestTemplate();

// 创建请求体
List<NameValuePair> params = new ArraysList<>();
params.add(new BasicNameValuePair("name","张三"));
params.add(new BasicNameValuePair("age","15"));
//....... 设置大量内容

// 设置请求头
HttpHeaders headers = new HttpHeaders();

// 创建HttpEntity对象
HttpEntity<String> httpEntity = new HttpEntity<>(null,headers);
URI uri = URI.create(url);
if(!CollectionUtils.isEmpty(params)){
	String param = URLEncodedUtils.format(params, StandardCharsets.UTF_8);
	uri = URI.create(url+"?"+param);
}
// 发送POST请求
String response = restTemplate.exchange(uri, HttpMethod.POST, httpEntity , String.class).getBody();

四、避免误区

  • 不要使用RestTemplate的getForObject发送 POST 请求(GET 请求参数只能在 URL 中,本身就容易触发 414)。
  • 即使是 POST 请求,若通过url + “?key=” + value拼接参数,本质仍是将参数放在 URL 中,会导致同样的错误。
  • 若接口必须要求参数在 URL 中(不符合 POST 规范,但某些旧接口可能如此),则需要缩短参数长度,或联系服务器端放宽 URL 长度限制(不推荐,因为 URL 长度本身有协议限制)。

五、总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • SpringBoot整合RocketMq实现分布式事务

    SpringBoot整合RocketMq实现分布式事务

    这篇文章主要为大家详细介绍了SpringBoot整合RocketMq实现分布式事务的相关知识,文中的示例代码讲解详细,有需要的小伙伴可以参考一下
    2024-11-11
  • Java解决线程的不安全问题之volatile关键字详解

    Java解决线程的不安全问题之volatile关键字详解

    这篇文章主要介绍了Java解决线程的不安全问题之volatile关键字详解,可见性指一个线程对共享变量值的修改,能够及时地被其他线程看到,而 volatile 关键字就保证内存的可见性,需要的朋友可以参考下
    2023-08-08
  • Java9垃圾回收方法finalize() 原理解析

    Java9垃圾回收方法finalize() 原理解析

    这篇文章主要介绍了Java9垃圾回收方法finalize() 原理解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-02-02
  • SpringBoot如何优雅的整合Swagger Api自动生成文档

    SpringBoot如何优雅的整合Swagger Api自动生成文档

    在多人协作的开发过程中,API文档不仅可以减少等待,也能保证开发的持续进行,这篇文章主要给大家介绍了关于SpringBoot如何优雅的整合Swagger Api自动生成文档的相关资料,需要的朋友可以参考下
    2021-07-07
  • Java多线程定时器Timer原理及实现

    Java多线程定时器Timer原理及实现

    这篇文章主要介绍了Java多线程定时器Timer原理及实现,涉及Timer的schedule的使用,定时器Timer的schedule等相关内容以及代码示例,具有一定参考价值,需要的朋友可以了解下。
    2017-11-11
  • Java String源码分析并介绍Sting 为什么不可变

    Java String源码分析并介绍Sting 为什么不可变

    这篇文章主要介绍了Java String源码分析并介绍Sting 为什么不可变的相关资料,需要的朋友可以参考下
    2017-02-02
  • Java中遍历Map的多种方法示例及优缺点总结

    Java中遍历Map的多种方法示例及优缺点总结

    在java中遍历Map有不少的方法,下面这篇文章主要给大家介绍了关于Java中遍历Map的多种方法,以及各种方法的优缺点总结,文中通过示例代码介绍的非常详细,对大家具有一定的参考学习价值,需要的朋友们下面来一起看看吧。
    2017-07-07
  • SpringBoot多环境配置与启动banner修改的操作详解

    SpringBoot多环境配置与启动banner修改的操作详解

    这篇文章主要介绍了如何自定义SpringBoot的启动banner和设置多环境配置,第一部分教如何通过在线工具生成并配置自定义banner,增强项目辨识度,第二部分解释了使用Profile来管理不同环境(开发、测试、生产)的配置,需要的朋友可以参考下
    2025-10-10
  • Java实现简单密码加密功能

    Java实现简单密码加密功能

    这篇文章主要为大家详细介绍了Java实现简单密码加密功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-03-03
  • 从架构思维角度分析分布式锁方案

    从架构思维角度分析分布式锁方案

    这篇文章主要介绍了从架构与思维的角度来分析分布式锁的方案,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-01-01

最新评论