unknownformatconversionexception 是 java 格式化方法因非法转换符（如 %q、%s%、%{name}）、未转义的单个 % 或参数类型不匹配而抛出的运行时异常，需用 %% 转义百分号，并借助 ide 检查与单元测试预防。
UnknownFormatConversionException 是 Java 中 String.format()、PrintStream.printf() 等格式化方法抛出的运行时异常，表示格式字符串里出现了无法识别的转换符（比如写错了占位符）。
检查格式字符串中的非法转换符
最常见的原因是格式化字符串中用了不支持的字母作为转换标识，例如：
-
"%q"——q不是合法的格式转换符（正确如%s、%d、%f） -
"%s%"—— 尾部多了一个孤立的%，会被误认为开始新转换 -
"%{name}"—— 混淆了String.format()（用%）和 SLF4J/Log4j 的{}占位符
确认转义百分号是否写对
如果真想输出一个 % 字符，必须写成 %%。写成 % 单个就会触发异常：
- ❌ 错误：
String.format("进度：%") - ✅ 正确：
String.format("进度：%%") - ✅ 多个：
String.format("折扣：%d%%", 95)→ 输出 “折扣：95%”
核对参数类型与转换符是否匹配
虽然这通常抛 IllegalFormatConversionException，但某些边界情况（如自定义格式或 locale 下）也可能关联到解析失败。确保：
-
%d对应整数（int/long），不能传String -
%s可接收任意对象（调用toString()），最安全 -
%t系列用于日期，需配合java.util.Date或TemporalAccessor
用 IDE 实时提示和单元测试提前发现
现代 IDE（IntelliJ IDEA / Eclipse）会对格式字符串做静态检查，标红错误转换符。建议：
- 开启编译器警告（如 IntelliJ 的 “Format string syntax error” inspection）
- 对关键格式化逻辑写简短单元测试，覆盖各种输入，避免上线后崩溃
- 日志中慎用
String.format()，优先考虑 SLF4J 的logger.info("msg: {}", var)，更安全且延迟格式化
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
