Java应用（JOOQ）插入MySQL UTF-8字符串异常问题求助

这种情况我之前排查过好多次，核心问题基本都出在Java端的数据库连接配置上——毕竟phpMyAdmin能正常插入，说明数据库本身的字符集配置是没问题的。咱们一步步来解决：

1. 检查JDBC连接URL的字符集参数 #

这是最常见的原因！JDBC连接MySQL时，默认可能不会自动用UTF-8编码传输数据，哪怕数据库本身是utf8。你需要在连接URL里明确加上字符集相关参数：

// 替换成你的数据库地址和名称
String url = "jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC";

如果业务需要支持emoji这类4字节UTF-8字符，建议把characterEncoding=utf8改成characterEncoding=utf8mb4，同时数据库字符集也可以升级为utf8mb4（完全兼容原utf8数据）。

2. 确认JOOQ的数据源配置继承了正确的字符集 #

JOOQ是基于JDBC的，只要底层JDBC连接配置正确，JOOQ就会自动沿用。如果用Spring Boot这类框架，检查配置文件里的数据源URL是否包含上述参数：

# application.properties示例
spring.datasource.url=jdbc:mysql://localhost:3306/your_database?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC
spring.datasource.username=your_username
spring.datasource.password=your_password

3. 验证表和字段的字符集是否一致 #

虽然库级设置了utf8，但个别表或字段可能被意外设成了其他字符集（比如latin1）。执行下面的SQL检查你的表结构：

SHOW CREATE TABLE executors; -- 替换成你的表名

如果发现字段字符集不是utf8，执行修改语句：

ALTER TABLE executors MODIFY COLUMN your_column VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_unicode_ci;

4. 排查Java代码中的字符串编码 #

确保要插入的字符串本身是正确的UTF-8编码。比如在插入前打印字符串的字节信息，确认没有乱码：

String yourString = "要插入的UTF-8字符串";
System.out.println("字符串内容：" + yourString);
System.out.println("UTF-8字节长度：" + yourString.getBytes(StandardCharsets.UTF_8).length);

另外，要保证你的Java代码文件本身是UTF-8编码（IDE一般默认是，但可以检查一下）。

5. 升级MySQL JDBC驱动版本 #

旧版本的JDBC驱动可能存在字符集兼容bug，建议升级到最新官方驱动。如果用Maven，依赖可以这么写：

<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.0.33</version> <!-- 替换成最新稳定版 -->
</dependency>

按上面的步骤排查，大概率能解决你的问题。我之前碰到的类似情况，都是JDBC URL没加字符集参数导致的，先把这个补上试试！

内容的提问来源于stack exchange，提问作者FirePapaya