Java中replaceAll替换{{MARKER}}遇${}报错的解决方法

问题原因 #

Java的String.replaceAll()方法会将替换字符串中的${xxx}解析为正则捕获组的引用，即使这些内容不在匹配到的目标片段中。当原字符串包含${test}这类格式的内容时，替换过程中会尝试查找对应名称的捕获组，找不到就抛出No group with name {test}异常；如果格式不完整（比如${test），则会抛出named capturing group is missing trailing '}'异常。

解决方案 #

方案一：使用Matcher.appendReplacement手动处理（支持正则匹配场景） #

通过Matcher的API手动完成替换，并用Matcher.quoteReplacement()转义替换字符串中的特殊字符，避免$符号被误解析：

String baseString = "any string ${test} with marker {{TEST_MARKER}} here";
String key = "TEST_MARKER";
String val = "123";
String pattern = String.format("\\{\\{%s\\}\\}", key);
Pattern p = Pattern.compile(pattern);
Matcher m = p.matcher(baseString);
StringBuffer resultBuffer = new StringBuffer();

while (m.find()) {
    // 自动转义替换字符串中的$和\
    m.appendReplacement(resultBuffer, Matcher.quoteReplacement(val));
}
m.appendTail(resultBuffer);
String finalResult = resultBuffer.toString();

方案二：改用String.replace()（简单字面量替换场景） #

如果你的需求只是替换固定格式的字符串（不需要正则匹配的复杂逻辑），直接用String.replace()即可。这个方法是字面量替换，不会把参数当成正则处理，也不会解析$符号：

String baseString = "any string ${test} with marker {{TEST_MARKER}} here";
String key = "TEST_MARKER";
String val = "123";
String targetStr = String.format("{{%s}}", key);
String result = baseString.replace(targetStr, val);

这个方案代码更简洁，性能也更优，适合你的场景。

方案三：手动转义替换字符串中的$符号（兼容replaceAll的场景） #

如果必须使用replaceAll()，可以手动转义替换字符串中的$符号：

String baseString = "any string ${test} with marker {{TEST_MARKER}} here";
String key = "TEST_MARKER";
String val = "123";
String pattern = String.format("\\{\\{%s\\}\\}", key);
// 将$替换为\$，避免被解析为捕获组引用
String escapedVal = val.replace("$", "\\$");
String result = baseString.replaceAll(pattern, escapedVal);

注意：如果替换字符串中包含反斜杠\，还需要额外转义，因此这个方案不如前两种可靠。

推荐方案 #

优先选择方案二，因为它逻辑简单、代码简洁，且完全符合你替换固定标记字符串的需求；如果需要正则匹配的灵活性（比如标记有动态匹配规则），则选择方案一。

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