IllegalFormatConversionException 是 Java 运行时异常，因 String.format() 等方法中格式符（如 %d）与参数类型不匹配（如用 %d 传 String）而抛出；常见于类型推断错误、大小写混淆（%S）、非数字对象误用数值格式符等场景。
IllegalFormatConversionException 是什么错误
这是 Java 格式化字符串时抛出的运行时异常，本质是 String.format() 或 System.out.printf() 试图用某个格式符（比如 %d）去处理一个不兼容的参数类型（比如传了 String 却用了 %d）。
它不是编译期报错，所以容易漏测；一旦触发，程序直接中断，日志里会明确写出「Conversion = d, Argument = class java.lang.String」这类信息。
常见触发场景和对应修复
最常踩坑的地方不是“写错”，而是“类型推断错”或“自动装箱/拆箱干扰”。
-
%d期望int、long等整数类型，但传了Integer为null→ 实际抛的是NullPointerException；但如果传了非数字对象（如new Object()），才真正触发IllegalFormatConversionException -
%s安全，几乎任何对象都能转成字符串；但误写成%S（大写）也会报这个异常 —— 因为%S是%s的大写版，只接受CharSequence，传Integer就挂 - 用
%f格式化Double.NaN或Double.POSITIVE_INFINITY不会报这个异常，但用%d格式化Double值一定会报
怎么快速定位和验证
别靠猜。看异常栈顶那行，找到具体是哪个 String.format() 调用点，然后检查它的格式串和参数列表一一对应关系。
立即学习“Java免费学习笔记（深入）”；
- 把格式串复制出来，逐个数
%符号个数，再数参数个数，是否相等 - 对每个
%x，查 JDK 文档确认它支持哪些类型（例如%t系列只认java.util.Date或long时间戳） - 临时把参数全换成
%s，看是否还报错 —— 如果不报了，说明至少有一个格式符和类型对不上
示例：String.format("id=%d, name=%s", "123", "Alice") → 第一个参数 "123" 是 String，但 %d 要求整数，立刻崩。
兼容性和替代方案建议
Java 15+ 加了更严格的格式检查，老版本可能“侥幸通过”某些模糊转换（比如把 Boolean 传给 %s），但不要依赖。
- 优先用
Objects.toString(x)替代强行格式化不确定类型的变量 - 对数值字段，显式转型比依赖自动拆箱更安全：比如
(int) obj前先instanceof Integer判断 - Log 框架（如 SLF4J）的占位符（
{}）完全绕过printf机制，不会抛这个异常，适合日志场景
真正麻烦的是嵌套调用 —— 比如工具方法内部拼接字符串又透传格式参数，这时候类型信息在调用链中丢失得最彻底。
