Linux字符集正常，Springboot打包jar后new File取不到中文路径，启动日志乱码

后端

2023-12-06 15:04:56

解决 Linux 环境下 Spring Boot 打包后读取中文路径和日志乱码问题

问题分析

在 Linux 环境下运行 Spring Boot 打包后的 JAR 文件时，用户可能会遇到以下问题：

无法访问中文路径： 程序中的 new File 方法无法正确读取带有中文字符的路径。
日志中出现乱码： 控制台输出的日志信息中包含乱码。

这些问题通常是由字符集不匹配和环境变量未设置导致的。

字符集不匹配

Spring Boot 在打包 JAR 文件时默认使用 UTF-8 字符集，而 Linux 系统默认使用 GB2312 字符集。当 JAR 文件在 Linux 系统上启动时，由于字符集不匹配，程序无法正确识别中文路径和日志中的中文字符。

环境变量未设置

在 Linux 系统中，需要设置环境变量 LANG 为 UTF-8，以确保系统使用 UTF-8 字符集。如果该环境变量未设置，可能会导致字符集不匹配问题。

解决方案

要解决这些问题，可以采取以下步骤：

1. 修改 JAR 包打包字符集

在打包 Spring Boot JAR 文件时，可以通过 Maven 编译器插件指定字符集为 UTF-8。在 pom.xml 文件中添加以下配置：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.8.1</version>
  <configuration>
    <encoding>UTF-8</encoding>
  </configuration>
</plugin>

2. 设置 LANG 环境变量

在 Linux 系统中，可以使用以下命令设置 LANG 环境变量为 UTF-8：

export LANG=zh_CN.UTF-8

3. 添加 JVM 参数

在启动 JAR 包时，可以通过添加 JVM 参数 -Dfile.encoding=utf-8 来指定字符集。

java -Dfile.encoding=utf-8 -jar my-app.jar

代码示例

以下代码示例演示如何创建一个带有中文路径的文件：

// 创建一个新的目录
File directory = new File("/Users/username/Desktop/新建目录");
// 在该目录下创建一个文件
File file = new File(directory, "测试.txt");
// 写入内容
BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(file), "UTF-8"));
writer.write("你好，世界！");
writer.close();