Unix系统下Jar程序记录含挪威语字符文件名乱码问题排查

核心问题分析 #

你的Java程序在Windows本地正常运行，但在Unix服务器以Jar包形式运行时，出现两个关键问题：

• 日志中的挪威语字符（å,ø,æ）显示为方块
• 抛出java.nio.file.NoSuchFileException异常

尽管服务器locale配置为en_US.UTF-8，且手动操作含特殊字符的文件正常，但Java程序的编码适配和API选择存在问题，导致字符解析错误。

解决方案 #

1. 启动Jar时强制指定JVM字符编码 #

运行Jar包时添加JVM参数，确保Java使用UTF-8处理文件系统和字符串：

java -Dfile.encoding=UTF-8 -jar your-application.jar

该参数会覆盖JVM默认的字符编码设置，避免因编码不匹配导致的文件名解析错误。

2. 替换旧File API为NIO2的Path和Files #

File类是Java早期API，对Unicode文件名的支持存在局限，改用NIO2 API能更可靠地处理特殊字符：

import java.nio.file.*;
import java.io.IOException;
import java.util.stream.Stream;

public static void scanFiles(Path dir) throws IOException {
    try (Stream<Path> stream = Files.list(dir)) {
        stream.forEach(path -> {
            try {
                if (Files.isDirectory(path)) {
                    scanFiles(path);
                } else {
                    String fileName = path.getFileName().toString();
                    if (fileName.contains("å") || fileName.contains("ø") || fileName.contains("æ")) {
                        logger.info("File: '{}'", fileName);
                    }
                }
            } catch (IOException e) {
                logger.error("处理路径出错: {}", path, e);
            }
        });
    }
}

public static void main(String[] args) {
    Path rootDir = Paths.get(path);
    try {
        scanFiles(rootDir);
    } catch (IOException ex) {
        logger.error("目录扫描失败", ex);
    }
}

NIO2的Path API专为跨平台Unicode文件操作设计，能更好适配Unix系统的文件编码规则。

3. 配置日志系统输出为UTF-8 #

日志中的方块字符是因为输出流未使用UTF-8编码，需在日志框架配置中指定编码：

• Logback（logback.xml）：

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <charset>UTF-8</charset>
        <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
</appender>

• Log4j2（log4j2.xml）：

<Console name="Console" target="SYSTEM_OUT">
    <PatternLayout charset="UTF-8" pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>

4. 验证环境变量传递 #

确保运行Jar时，Unix的locale环境变量正确传递给JVM，可在启动前打印确认：

echo $LANG
java -Dfile.encoding=UTF-8 -jar your-application.jar

原理说明 #

• Unix文件系统默认用UTF-8存储文件名，但JVM可能未自动继承系统编码，需手动指定file.encoding参数
• NIO2 API比旧File类对Unicode字符的支持更完善，避免编码转换丢失
• 日志输出若不指定UTF-8，会使用系统默认编码，导致特殊字符无法正常渲染

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