mysql jdbc中文乱码怎么办

发布时间：2021-12-26 08:48:49 作者：小新
来源：亿速云阅读：705

# MySQL JDBC中文乱码怎么办

## 前言

在使用Java程序通过JDBC连接MySQL数据库时，中文乱码是开发者经常遇到的问题。本文将全面分析乱码产生的原因，并提供多种解决方案，帮助开发者彻底解决MySQL JDBC中文乱码问题。

## 一、乱码产生的原因

### 1.1 字符集不匹配的三层结构
MySQL中文乱码通常由以下三层字符集不匹配导致：
- 客户端字符集（Java程序）
- 连接层字符集（JDBC传输）
- 数据库/表/字段字符集

### 1.2 常见乱码场景
1. 插入数据变成"???"或乱码
2. 查询结果显示为乱码
3. 数据在Java程序中正常，存入数据库后乱码

## 二、解决方案大全

### 2.1 JDBC连接参数配置（推荐）

在连接URL中添加字符集参数是最有效的解决方案：

```java
String url = "jdbc:mysql://localhost:3306/db_name?useUnicode=true&characterEncoding=UTF-8";

关键参数说明： - useUnicode=true：启用Unicode支持 - characterEncoding=UTF-8：指定客户端到服务器的编码

2.2 检查数据库字符集配置

2.2.1 查看当前字符集设置

SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';

2.2.2 修改数据库默认字符集

ALTER DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

2.2.3 修改表字符集

ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

2.3 服务端配置（my.cnf/my.ini）

在MySQL配置文件中添加：

[client]
default-character-set=utf8mb4

[mysql]
default-character-set=utf8mb4

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci

2.4 Java程序端处理

2.4.1 确保源代码文件编码

IDE中设置文件编码为UTF-8： - Eclipse：Window > Preferences > General > Workspace - IDEA：File > Settings > Editor > File Encodings

2.4.2 字符串显式转码

String value = new String(str.getBytes("ISO-8859-1"), "UTF-8");

2.5 使用最新JDBC驱动

建议使用8.x以上版本的MySQL Connector/J：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.28</version>
</dependency>

三、UTF-8与utf8mb4的选择

3.1 区别说明

utf8：MySQL中的”假UTF-8”，最多支持3字节
utf8mb4：真正的UTF-8，支持4字节（如emoji表情）

3.2 推荐方案

建议全部使用utf8mb4：

jdbc:mysql://localhost/db?useUnicode=true&characterEncoding=UTF-8

同时数据库也配置为utf8mb4

四、特殊场景处理

4.1 URL参数乱码

对于GET请求参数：

// Tomcat配置
<Connector URIEncoding="UTF-8" />

4.2 PreparedStatement处理

PreparedStatement ps = conn.prepareStatement("INSERT INTO test VALUES(?)");
ps.setString(1, "中文"); // 自动处理编码

4.3 连接池配置

以HikariCP为例：

HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost/db?useUnicode=true&characterEncoding=UTF-8");

五、调试技巧

5.1 十六进制查看实际存储

SELECT hex(column_name), column_name FROM table_name;

5.2 各环节编码检查

Java程序中的字符串
JDBC传输后的数据
数据库实际存储

六、总结

解决MySQL JDBC中文乱码的关键是保证各环节字符集统一，推荐组合方案： 1. JDBC连接字符串添加UTF-8参数 2. 数据库/表使用utf8mb4字符集 3. 确保应用服务器和客户端编码一致 4. 使用最新版JDBC驱动

通过以上配置，可以彻底解决99%的中文乱码问题。如仍遇到问题，建议使用十六进制调试法定位具体哪个环节出现了编码转换错误。 “`