当前位置：首页 > 后端开发 > 正文

Java中文乱码如何彻底解决？

解决Java项目中文乱码需统一编码设置：检查IDE（如IntelliJ/Eclipse）的项目编码、文件编码设为UTF-8；配置JVM启动参数添加-Dfile.encoding=UTF-8；确保源代码文件保存为UTF-8格式；数据库连接字符串指定字符集。

乱码根源分析

中文乱码本质是编码与解码不一致，常见场景：

IntelliJ/Eclipse：

File → Settings → Editor → File Encodings
将Global/Project/Default编码均设为UTF-8
勾选"Transparent native-to-ascii conversion"（解决.properties文件乱码）

Maven/Gradle：在构建脚本中显式指定编码

<!-- Maven示例 -->
<properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

在启动脚本中加入编码参数：

java -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -jar your_app.jar

原理：file.encoding影响字节流默认编码，sun.jnu.encoding解决文件路径中文问题

Tomcat：

修改conf/server.xml的Connector：

<Connector 
  URIEncoding="UTF-8" 
  useBodyEncodingForURI="true"
  connectionTimeout="..."
  port="8080" />

添加setenv.sh（Linux）或setenv.bat（Windows）：
```
export JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8"
```

连接字符串指定编码：
jdbc:mysql://localhost:3306/db?useUnicode=true&characterEncoding=UTF-8

验证数据库编码：

SHOW VARIABLES LIKE 'character_set%';  -- 确保全部为utf8mb4

表字段编码：

ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4;

字节流转换：

// 错误做法：使用默认编码
new FileReader("data.txt"); 
// 正确做法：显式指定UTF-8
new InputStreamReader(new FileInputStream("data.txt"), StandardCharsets.UTF_8);

HTTP请求/响应：

// Servlet示例
response.setContentType("text/html;charset=UTF-8");
request.setCharacterEncoding("UTF-8");

Spring Boot配置：

spring:
  http:
    encoding:
      force: true
      charset: UTF-8
      enabled: true

读写文本文件必须指定编码：

Files.readString(Path.of("file.txt"), StandardCharsets.UTF_8);
Files.writeString(Path.of("file.txt"), "中文内容", StandardCharsets.UTF_8);

检查当前JVM编码：

System.out.println("Default Charset: " + Charset.defaultCharset());
System.out.println("file.encoding: " + System.getProperty("file.encoding"));

在项目根目录创建encoding-enforcer.config：

# 强制所有环节使用UTF-8
-Dfile.encoding=UTF-8
-Dclient.encoding.override=UTF-8
-Dsun.jnu.encoding=UTF-8

并通过启动脚本加载该配置。

Oracle官方文档：《Java Platform Standard Edition 8 Documentation》”Character Encoding”章节
RFC 3629：UTF-8编码标准规范
MySQL 8.0 Reference Manual：Character Sets and Collations
Tomcat 10 Configuration Reference：Connector属性说明