<think>
我们正在解决
Spring接收POST
请求时
中文乱码的问题。根据引用内容，我们可以总结出以下几种解决方法：
### 方法1：配置字符
编码过滤器（推荐）
在`web.xml`中配置
Spring提供的`CharacterEncodingFilter`，并设置
编码为UTF-8。这个过滤器会强制
请求和响应使用指定的
编码。
```xml
<filter>
<filter-name>CharacterEncodingFilter</filter-name>
<filter-class>org.
springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<!-- 强制
请求编码 -->
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<
url-pattern>/*</
url-pattern>
</filter-mapping>
```
### 方法2：在
Spring Boot中配置
如果是
Spring Boot项目，可以在配置文件中设置：
```properties
server.servlet.encoding.force=true
server.servlet.encoding.charset=UTF-8
server.servlet.encoding.enabled=true
```
### 方法3：在控制器方法中指定produces属性
在@RequestMapping注解中指定produces属性，确保响应使用UTF-8
编码：
```
java
@RequestMapping(value = "testdemo1", method = RequestMethod.POST,
produces = "text/plain;charset=UTF-8")
@ResponseBody
public String testdemo1(@RequestBody String name) {
// ...
}
```
### 方法4：手动设置
请求编码
在读取
请求参数之前，设置
请求对象的字符
编码（需要在过滤器或拦截器中设置，或者在每个Controller方法中设置）：
```
java
request.setCharacterEncoding("UTF-8");
```
### 方法5：修改StringHttpMessageConverter的默认
编码
当使用RestTemplate或
Spring MVC的消息转换器时，需要确保使用的
编码是UTF-8。例如，配置RestTemplate：
```
java
RestTemplate restTemplate = new RestTemplate();
// 获取消息转换器列表
List<HttpMessageConverter<?>> converters = restTemplate.getMessageConverters();
for (HttpMessageConverter<?> converter : converters) {
if (converter instanceof StringHttpMessageConverter) {
((StringHttpMessageConverter) converter).setDefaultCharset(StandardCharsets.UTF_8);
}
}
```
### 方法6：在读取输入流时指定
编码
如果直接使用`Http
URLConnection`，则在读取输入流时指定
编码：
```
java
BufferedReader in = new BufferedReader(
new InputStreamReader(conn.getInputStream(), "utf-8")
);
```
### 原因分析
POST
请求乱码通常是因为容器（如Tomcat）默认使用ISO-8859-1
编码解析
请求，而客户端使用的是UTF-8。解决方法是在解析
请求参数之前设置正确的字符
编码。
### 最佳实践
- **推荐使用过滤器方法（方法1）**：配置简单，且能全局处理所有
请求。
- **对于
Spring Boot应用（方法2）**：使用配置文件设置更简洁。
- **注意**：设置字符
编码的操作必须在获取
请求参数之前执行，因此过滤器是最合适的。
[^1]: 引用[1]中提供的字符
编码过滤器配置。
[^4]: 引用[4]中在控制器方法中指定produces属性。
[^5]: 引用[5]中在读取输入流时指定
编码。
§§相关问题§§
1. 如何解决GET
请求的
中文乱码问题？
2. 在
Spring Boot中如何自定义消息转换器以支持多种
编码？
3. 如何测试
Spring MVC
接口的
中文编码是否正确？
</think>
###
Spring接收POST
请求中文乱码解决方案
中文乱码的根本原因是**字符
编码不一致**，以下是完整的解决方案：
#### 1. 配置全局字符
编码过滤器（推荐⭐）
在`web.xml`中添加
Spring官方提供的过滤器：
```xml
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>org.
springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<!-- 关键
参数：强制
请求响应均使用UTF-8 -->
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<
url-pattern>/*</
url-pattern>
</filter-mapping>
```
> 原理：在
请求到达Controller前强制设置
编码[^1]
#### 2.
Spring Boot配置（替代方案）
在`application.properties`中配置：
```properties
# 强制
请求/响应使用UTF-8
server.servlet.encoding.charset=UTF-8
server.servlet.encoding.force=true
```
#### 3. 控制器层解决方案
在Controller方法上指定
编码：
```
java
@PostMapping(value = "/api",
consumes = MediaType.APPLICATION_JSON_VALUE,
produces = "application/json;charset=UTF-8") // 关键设置
public ResponseEntity<String> handlePost(
@RequestBody String body) { // 直接
接收字符串
System.out.println("
接收数据：" + body); // 正常显示
中文
return ResponseEntity.ok(body);
}
```
> 使用`produces`明确指定响应
编码[^4]
#### 4. 手动
解码方案
```
java
@PostMapping("/manual")
public String manualDecode(HttpServletRequest request)
throws IOException {
// 手动设置
请求编码
request.setCharacterEncoding("UTF-8");
// 使用Reader读取避免
乱码
StringBuilder sb = new StringBuilder();
try (BufferedReader reader = request.getReader()) {
String line;
while ((line = reader.readLine()) != null) {
sb.append(line);
}
}
return sb.toString();
}
```
> 原理：在获取
参数前设置
编码[^3]
#### 5. RestTemplate
调用方解决方案
当作为客户端
调用时：
```
java
RestTemplate restTemplate = new RestTemplate();
// 关键：修改消息转换器
编码
restTemplate.getMessageConverters().forEach(converter -> {
if (converter instanceof StringHttpMessageConverter) {
((StringHttpMessageConverter) converter).setDefaultCharset(StandardCharsets.UTF_8);
}
});
// 发送
请求
String result = restTemplate.postForObject(
url, "
中文数据", String.class);
```
> 设置StringHttpMessageConverter默认
编码[^2][^5]
---
### 根本原因分析
| 阶段 |
编码不一致场景 | 解决方案 |
|------|----------------------------|-------------------------|
|
请求 | 浏览器UTF-8 vs 服务器ISO-8859-1 | 配置`forceEncoding` |
| 传输 | HTTP未声明charset | 设置`Content-Type`头 |
| 处理 |
Spring默认使用ISO-8859-1 | 修改消息转换器
编码 |
| 响应 | 未指定charset | 添加`produces`声明 |
> **最佳实践**: 同时使用过滤器(方案1)+控制器声明(方案3)可确保万无一失
该博客介绍了在Spring MVC中设置@RequestMapping的输入和输出字符集编码为UTF-8，并在web.xml中配置CharacterEncodingFilter确保整个应用的字符编码统一，以避免乱码问题。
扫一扫
2181
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
