Spring Boot 返回前端乱码的解决方案
在现代 web 开发中，字符编码的正确处理至关重要。Spring Boot 是一个流行的 Java 开发框架，有时在返回数据给前端时可能会遇到乱码问题。本文将为你详细介绍如何在 Spring Boot 中解决返回前端乱码的问题。
整体流程
以下是解决乱码问题的基本流程：
| 步骤 | 说明 |
|---|---|
| 1 | 确认项目编码开启为 UTF-8 |
| 2 | 在 Spring Boot 配置文件中设置编码 |
| 3 | 确认 Controller 中的请求和响应编码 |
| 4 | 测试接口，确保无乱码 |
每一步的具体操作
第一步：确认项目编码开启为 UTF-8
确保你的项目使用 UTF-8 编码。在 pom.xml 中设置以下内容：
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>
这段代码确保 Maven 编译和报告的编码格式为 UTF-8。
第二步：在 Spring Boot 配置文件中设置编码
在 application.properties 或 application.yml 中添加以下配置：
application.properties
spring.http.encoding.enabled=true
spring.http.encoding.charset=UTF-8
spring.http.encoding.force=true
application.yml
spring:
http:
encoding:
enabled: true
charset: UTF-8
force: true
这些配置确保 Spring Boot 将 HTTP 请求和响应的内容编码设置为 UTF-8。
第三步：确认 Controller 中的请求和响应编码
确保你的 Controller 类中的请求和响应都指定了编码方式。示例如下：
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class MyController {
@GetMapping(value = "/greet", produces = MediaType.APPLICATION_JSON_VALUE + ";charset=UTF-8")
public String greet() {
return "{\"message\":\"你好，世界！\"}"; // 返回 JSON 字符串，确保使用 UTF-8 编码
}
}
produces属性指定了返回的内容类型和编码，确保前端正确解析。
第四步：测试接口，确保无乱码
使用 Postman 或其他 HTTP 客户端测试接口：
- 发起 GET 请求到
http://localhost:8080/greet - 查看返回结果是否正确显示中文字符。
关系图示
下面是表示 Spring Boot 各部分之间关系的 ER 图：
erDiagram
Application {
string name
string description
}
Controller {
string requestMapping
string responseType
}
Service {
string serviceLogic
}
Repository {
string databaseConnection
}
Application ||--o{ Controller : has
Controller ||--o{ Service : calls
Service ||--o{ Repository : accesses
结尾
通过上述步骤，你应能够成功解决 Spring Boot 返回前端乱码的问题。确保编码格式在项目的各个层级上都设置接轨，从项目配置到具体的 Controller 实现，最终返回给前端的数据可以正确无误地显示。遇到类似的问题时，始终要从字符编码的角度去检查和调试。希望这篇文章能为你在开发过程中提供帮助，欢迎随时提问！
