IllegalFormatConversionException是Java中String.format()等方法因格式说明符（如%d、%f）与参数实际运行时类型不匹配而抛出的运行时异常，属IllegalFormatException子类；常见于%d传String、%f传int等场景，需确保类型严格兼容或显式转换。
IllegalFormatConversionException 是 Java 中 String.format() 方法在格式化字符串时，**占位符类型与实际传入参数类型不匹配**所抛出的运行时异常。它属于 IllegalFormatException 的子类，常见于开发调试阶段，但容易被忽略，直到运行时才暴露。
核心原因：格式说明符和参数类型对不上
Java 要求每个格式化占位符（如 %d、%s、%f）必须与对应位置参数的**实际运行时类型兼容**。例如：
-
%d期望int、long、short等整数类型，传入String或Double就会报错； -
%f期望浮点类型（float、double），传入Integer会失败（自动装箱不解决类型匹配问题）； -
%s最宽容，基本所有对象都支持（调用toString()），但不是万能解药——比如用%s格式化 null 可能引发空指针，而%d遇到 null 直接抛IllegalFormatConversionException。
典型错误示例及修复方式
以下代码都会触发该异常：
String s = String.format("%d", "123"); // ❌ String 不能用于 %d
String s = String.format("%f", 42); // ❌ int 不是 float/double
String s = String.format("%d", null); // ❌ null 无法转为数字
String s = String.format("%d", new Object()); // ❌ Object 无数字语义
修复方法很简单：确保类型一致或显式转换：
- 用
%s替代非数字场景（如日志中打印任意对象）； - 对数字参数做显式转型：
String.format("%f", (double) 42)； - 对可能为 null 的数字字段，先判空再格式化，或用
Objects.toString(x, "0")转为字符串后用%s； - 使用
String.valueOf(x)+ 字符串拼接，绕过格式化机制（适合简单场景）。
如何快速定位问题
异常堆栈通常明确指出哪一列出了问题：
java.util.IllegalFormatConversionException: d != java.lang.String含义是：第 %d 占位符期待数字类型，但实际传入了 String。重点看异常消息中的两个类型（d 和 java.lang.String），再对照 format 调用中参数列表的顺序，就能准确定位到第几个参数出错。
预防建议
- IDE（如 IntelliJ）通常会在编辑时标出类型不匹配警告，开启并重视这些提示；
- 避免在格式化中混用原始类型和包装类，统一用包装类（如
Integer）便于判空处理； - 对用户输入或外部数据做格式化前，先校验是否为有效数字，而非依赖
String.format去“兜底”； - 复杂格式需求考虑使用
MessageFormat或模板引擎（如 StringTemplate），它们对类型更宽松或提供更好错误反馈。
