MessageFormat.format处理变量中的花括号转义该怎么做？

在Java国际化与动态消息拼装场景中，MessageFormat.format是最常用的工具方法之一。它允许开发者通过类似{0}、{1,number}这样的占位符，把运行时的变量安全地填入模板。但当变量值本身包含花括号，例如用户提交了一段JSON字符串或者一段计算公式，MessageFormat会错误地将这些花括号识别为子格式定义，从而引发IllegalArgumentException或者输出内容被截断。理解它的解析机制，是正确处理转义的前提。

MessageFormat的占位符解析原理

MessageFormat在内部使用了一个名为MessagePattern的解析器，它会逐字符扫描模板字符串。一旦发现左花括号{，就会尝试读取后面的数字作为参数索引，并继续寻找匹配的右花括号}来结束占位符。如果模板里写的是Hello {0}，而传入的{0}对应字符串是{name: "tom"}，解析器并不会把变量里的花括号当作普通字符，因为占位符替换发生在解析模板之后，变量内容原样嵌入，但后续若模板中还有未闭合结构就会混乱。

更麻烦的情况是，当变量出现在含有嵌套格式定义的模板中，例如{0,choice,0#无{1}|1#有{1}}，如果{1}的值是{count}，格式化过程中会触发二次解析，导致系统把{count}当成新的占位符去查找不存在的参数。这种机制决定了我们不能假设变量中的花括号会被自动忽略，而必须在传入前或模板设计阶段就处理好转义。

从源码角度看，MessageFormat对单引号'有特殊处理：一对单引号之间的内容会被视为引号字符串，其中的花括号失去特殊含义。但这个规则在只出现单个单引号时又会变化，单个单引号会被当作转义符吃掉。这种不一致性正是很多开发者在转义时翻车的核心原因。

三种常见的花括号转义方案对比

第一种方案是使用单引号包裹变量中的花括号。根据MessageFormat规则，写成'{'和'}'可以让花括号被当作字面量。但需要注意，如果变量整体来自外部输入，你应当在代码里将{替换为'{'，将}替换为'}'。示例代码如下：

String userInput = "{ "age": 18 }";
// 将变量中的花括号用单引号包裹
String escaped = userInput.replace("{", "'{'").replace("}", "'}'");
String pattern = "用户资料: {0}";
String result = MessageFormat.format(pattern, escaped);
System.out.println(result);

第二种方案是修改模板，用双单引号转义模板里的静态花括号，但这对变量内容无效，因此仅适合模板固定而变量无花括号的场景。第三种方案是预先拆分消息，不使用MessageFormat拼装含危险字符的片段，改为字符串直接拼接或改用StringBuilder。三种方案各有优劣：单引号法兼容原有国际化文件，但需小心单引号原本含义；拆分法最安全却牺牲了模板统一性；双单引号法局限性大。

实践中，若项目大量使用ResourceBundle管理多语言，推荐在工具类中统一提供escapeMessageArgument方法，把所有传入format的动态参数先做花括号与单引号转义，避免业务代码散落各种替换逻辑。这样也方便后续统一升级到java.text之外更现代的模板引擎。

结合真实场景的完整代码示例

假设我们要给玩家发送一条提示，模板为玩家 {0} 提交了配置 {1}，请审核，其中{1}是用户上传的一段带花括号的规则文本。如果不转义，当规则文本为{ "open": true }时，虽然本例模板没有嵌套格式，但一旦运维将模板改为含choice子格式就会崩。稳妥做法是在发送前转义：

import java.text.MessageFormat;

public class NoticeDemo {
    public static String safeFormat(String pattern, Object... args) {
        for (int i = 0; i < args.length; i++) {
            if (args[i] instanceof String) {
                String s = (String) args[i];
                // 先转义已有的单引号，再包裹花括号
                s = s.replace("'", "''");
                s = s.replace("{", "'{'").replace("}", "'}'");
                args[i] = s;
            }
        }
        return MessageFormat.format(pattern, args);
    }

    public static void main(String[] args) {
        String template = "玩家 {0} 提交了配置 {1}，请审核";
        String name = "小白";
        String config = "{ "open": true, "limit": 5 }";
        String msg = safeFormat(template, name, config);
        System.out.println(msg);
    }
}

上面的safeFormat方法首先把参数里的单引号变成双单引号，防止原有单引号干扰后续的包裹逻辑；随后把花括号用单引号界定。经过这一步，无论模板以后怎么改，变量里的花括号都不会被误解析。运行结果会正确输出玩家 小白 提交了配置 { "open": true, "limit": 5 }，请审核。

如果团队正在使用日志框架如Log4j2，其底层也借用了类似MessageFormat的语法，同样适用本转义思路。建议把转义工具类打包为公共组件，并在代码评审中检查所有直接调用MessageFormat.format且参数来源于外部请求的地方，从源头降低故障率。

MessageFormat花括号转义Java国际化修改时间：2026-08-17 13:58:33