从实践中发现到解决SpringBoot中文乱码的方法

2023-09-25 20:36:05

问题现象

使用SpringBoot框架开发项目时，常常遇到请求中的中文保存到数据库后会乱码的问题。乱码的字符并不是什么特殊字符，且删除了乱码字符前面的字符后，乱码的地方会向后偏移。

问题分析

1. 字符编码

首先考虑字符编码问题。SpringBoot默认使用UTF-8字符编码，但如果数据库或其他组件的字符编码不一致，就会导致乱码问题。

可以通过在application.properties文件中添加spring.http.charset=UTF-8和spring.datasource.url=jdbc:mysql://localhost/database?characterEncoding=UTF-8来显式指定字符编码。

2. 请求参数

如果请求参数中包含中文，则需要对请求参数进行编码。

可以通过在application.properties文件中添加spring.mvc.contentnegotiation.favor-path-extension=false来禁用路径扩展名协商，并使用@RequestParam(value = "name", required = false, defaultValue = "") String name这样的方式来接收请求参数。

3. 数据库

如果数据库的字符集不正确，也会导致乱码问题。

可以通过在创建数据库或表时显式指定字符集，例如：

CREATE DATABASE database CHARACTER SET utf8mb4;

CREATE TABLE table (name VARCHAR(255) CHARACTER SET utf8mb4);

4. JDBC连接池

如果使用JDBC连接池，则需要确保连接池的字符编码与数据库的字符编码一致。

可以通过在创建连接池时显式指定字符编码，例如：

DriverManagerDataSource dataSource = new DriverManagerDataSource();
dataSource.setUrl("jdbc:mysql://localhost:3306/database?characterEncoding=UTF-8");
dataSource.setUsername("username");
dataSource.setPassword("password");

问题解决方案

通过逐一排查，最终解决了SpringBoot中文乱码问题。

解决方案如下：

在application.properties文件中添加spring.http.charset=UTF-8和spring.datasource.url=jdbc:mysql://localhost/database?characterEncoding=UTF-8来显式指定字符编码。
在application.properties文件中添加spring.mvc.contentnegotiation.favor-path-extension=false来禁用路径扩展名协商，并使用@RequestParam(value = "name", required = false, defaultValue = "") String name这样的方式来接收请求参数。
在创建数据库或表时显式指定字符集，例如：

CREATE DATABASE database CHARACTER SET utf8mb4;

CREATE TABLE table (name VARCHAR(255) CHARACTER SET utf8mb4);

在创建JDBC连接池时显式指定字符编码，例如：

DriverManagerDataSource dataSource = new DriverManagerDataSource();
dataSource.setUrl("jdbc:mysql://localhost:3306/database?characterEncoding=UTF-8");
dataSource.setUsername("username");
dataSource.setPassword("password");