Java 的 String.format 里 100% 漏转义 日志整行抛异常后怎么写

日志里冒出一行 java.util.UnknownFormatConversionException: Conversion = '%',栈顶是 String.format。触发点是运营在模板里写了完成 100% 这么一句,format 把它当成转换符,整行日志没打出来,异常还被外层 catch 吞掉,直到排查别的问题才发现少了一整段。

第一反应是把 % 换成 # 先绕过去,日志能打了但内容不对。也想过换 slf4j 的 {} 占位符,那确实能用,可这段代码是拿 format 拼 SQL 片段和提示语,不是一句 logger.info 能替掉的。

试过在 format 之前 replace 掉百分号,结果原本写了两个 % 的地方被替换成四个,反而多出一个转换符,校验函数当场报参数个数不匹配。转义这种事不能做两遍,必须在模板源头一次写对。

最后定成两条规矩:格式串里所有 % 一律写两个,占位符只用 %s 和 %d,不允许带索引的写法;拼接前先跑一遍校验,数 % 的个数和参数个数对不对得上。

踩完才回头看异常信息,Conversion = '%' 已经把出错那个字符指出来了,一开始只瞥了一眼异常类名就急着改代码,白绕半小时。

确认口径:全仓搜出 37 处 format 调用逐个过一遍;补一个单测用 12 条真实模板跑,0 异常;上线一周后日志行数和请求数对得上,没有缺行。

// 格式串里的百分号要写成两个
log.info(String.format("完成 100%% 耗时 %d ms", cost));
// 或者干脆用占位符 不经过 format
log.info("完成 100% 耗时 {} ms", cost);

您可以还会对下面的文章感兴趣: