Java如何正确为日志FileHandler设置UTF-8编码解决文件乱码问题

问题根因 #

你遇到的乱码核心是编码设置时机错误，和StandardCharsets.UTF_8.name()/toString()的取值无关：

• FileHandler在构造函数执行阶段就会按JVM默认编码打开文件输出流、初始化写入字符流，你在构造完成后再调用setEncoding()，大部分OpenJDK/OracleJDK版本下这个操作不会替换已经初始化的输出流，编码设置完全不生效。
• 你看到的planmäßig是典型的编码不匹配特征：正确的UTF-8编码字节被单字节编码（ISO-8859-1/Windows-1252）解码时就会出现这类乱码。
• ConsoleHandler不需要手动设置编码：IntelliJ控制台会自动适配项目/系统编码，你强行指定UTF-8如果和控制台实际解码编码不匹配，反而会出现控制台乱码，保持默认即可正常显示。

修复步骤 #

1. 调整FileHandler初始化顺序，优先设置编码 #

把setEncoding调用移到FileHandler实例创建后的第一行，确保在任何日志写入、其他配置设置前完成编码指定，修改后的初始化代码如下：

private Handler initializeFileHandler() {
    LogManager.getLogManager().reset();
    Handler handler = null;
    try {
        Files.deleteIfExists(Paths.get(logPath));
        handler = new FileHandler(logPath);
        // 构造实例后第一时间设置编码，不要延后
        handler.setEncoding(StandardCharsets.UTF_8.name());
        handler.setLevel(Level.FINER);
        handler.setFormatter(new Formatter() {
            @Override
            public String format(LogRecord record) {
                return String.format(
                        "%s: Class: %s; Type: %s; %s%s",
                        formatter.format(LocalDateTime.now()),
                        record.getLoggerName(),
                        record.getLevel(),
                        record.getMessage(),
                        System.lineSeparator()
                );
            }
        });
    } catch (IOException ex) {
        System.err.println("Fehler beim initialisieren vom FileHandler");
        ex.printStackTrace();
        System.exit(1);
    }
    return handler;
}

2. 兜底方案：JVM启动参数指定默认编码 #

如果上述调整后仍不生效，直接在应用启动时加JVM参数，强制指定JUL FileHandler的默认编码为UTF-8，从根源避免构造时取错系统默认编码：

-Djava.util.logging.FileHandler.encoding=UTF-8

加完这个参数后，哪怕你不手动调用setEncoding，FileHandler也会默认用UTF-8写入文件。

3. ConsoleHandler保持默认配置 #

不要给ConsoleHandler手动调用setEncoding，保留默认逻辑即可自动适配IntelliJ控制台编码，不会出现乱码：

public ConcurrentLogger initializeLogger(ConcurrentLogger logger) {
    logger.addHandler(fileHandler);

    Handler consoleHandler = new ConsoleHandler();
    consoleHandler.setLevel(Level.FINER);
    // 不要加consoleHandler.setEncoding()相关代码
    logger.addHandler(consoleHandler);

    logger.setLevel(Level.ALL);
    return logger;
}

验证说明 #

改完后重新生成日志文件，用Notepad++/IntelliJ以UTF-8编码打开，就能看到正确的德语文本BruteForce wird planmäßig beendet.，不会再出现乱码。如果仍有乱码，需要排查传入日志的原始字符串本身是否在读取阶段就已经因为编码错误变成乱码，和FileHandler配置无关。

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