java Logger 如何国际化

在 Java 中使用 Logger 做国际化（i18n），核心思路是：日志消息不直接写死字符串，而是使用“消息 Key + 资源文件（ResourceBundle）”来根据语言环境输出不同语言的日志。

下面按常见方式说明。

一、核心思路

1. 日志中只记录 消息 Key（如 log.user.login.success）
2. 使用 ResourceBundle 存放不同语言的消息模板
3. 在输出日志前，根据 Locale 从 ResourceBundle 中取消息
4. Logger 只负责“记录”，不负责“翻译”

二、使用 java.util.logging（JUL，官方自带）

1. 定义资源文件

messages_en.properties

log.user.login=User {0} logged in
log.user.logout=User {0} logged out

messages_zh.properties

log.user.login=用户 {0} 登录成功
log.user.logout=用户 {0} 退出登录

2. 创建 Logger（绑定 ResourceBundle）

import java.util.*;
import java.util.logging.*;

public class I18nLoggerExample {
    public static void main(String[] args) {
        Locale locale = Locale.CHINESE; // 可动态切换
        ResourceBundle bundle = ResourceBundle.getBundle("messages", locale);

        Logger logger = Logger.getLogger("com.example");
        logger.setResourceBundle(bundle);

        logger.log(Level.INFO, "log.user.login", "Alice");
    }
}

✅ 输出（中文环境）：

用户 Alice 登录成功

3. 带参数的日志（MessageFormat）

JUL 会自动使用 MessageFormat 处理 {0} {1}

logger.log(Level.INFO, "log.user.login", new Object[]{"Bob"});

三、使用 SLF4J + Logback（更常见）

SLF4J 本身不负责国际化，需要自己处理

方式一：手动国际化（推荐、清晰）

Locale locale = Locale.ENGLISH;
ResourceBundle bundle = ResourceBundle.getBundle("messages", locale);

String msg = bundle.getString("log.user.login");
logger.info(MessageFormat.format(msg, "Alice"));

方式二：封装一个 I18n Logger 工具类

public class I18nLogger {
    private static final Logger log = LoggerFactory.getLogger(I18nLogger.class);

    public static void info(Locale locale, String key, Object... args) {
        ResourceBundle bundle = ResourceBundle.getBundle("messages", locale);
        String pattern = bundle.getString(key);
        String msg = MessageFormat.format(pattern, args);
        log.info(msg);
    }
}

使用：

I18nLogger.info(Locale.CHINESE, "log.user.login", "Alice");

四、Log4j2 的国际化支持（最完善）

Log4j2 原生支持国际化

1. 配置 Logger

Logger logger = LogManager.getLogger("i18nLogger");

2. 资源文件

messages_en.properties
messages_zh.properties

3. 使用

logger.info("log.user.login", "Alice");

Log4j2 会根据 Locale.getDefault() 自动选择语言。

五、最佳实践建议

✅ 日志中保留 Key（可选）

logger.info("{} | {}", "log.user.login", MessageFormat.format(msg, user));

✅ 异常信息不国际化

• 技术异常保持英文（方便排查）

✅ 用户界面 vs 日志

• 用户提示：国际化
• 系统日志：尽量英文 + Key

六、总结

如果你告诉我 用的是哪种日志框架（Logback / Log4j2 / JUL），我可以给你一份可直接用的完整示例。