illegalformatconversionexception是java中因格式说明符（如%d、%s）与实际参数类型不匹配而抛出的运行时异常；常见于%d传string、%f传integer、%t传string等场景，需严格按formatter语法校验类型兼容性。
IllegalFormatConversionException 是 Java 中 java.util.Formatter（以及依赖它的 String.format()、System.out.printf() 等）在格式化字符串时抛出的运行时异常，核心原因是：**指定的格式说明符（如 %d、%s、%f）与实际传入的参数类型不兼容**。
常见触发场景
这类异常不是编译期检查的，只有在运行时格式化执行过程中才会暴露。典型情况包括：
-
%d（期望整数）却传入了String或Double -
%s（通用字符串）被误用于基本类型数组（如int[]），而它无法自动转成可读字符串 -
%f（浮点数）传入了Integer或String - 使用
%t时间格式但参数不是java.util.Date、long或实现了TemporalAccessor的类型
如何快速定位问题
异常堆栈会明确指出哪一行、哪个格式化调用出错，并通常包含类似 Conversion = 'd', Argument class = java.lang.String 的提示——这说明你用了 %d 却传了个字符串。
检查顺序建议：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 对照格式字符串中每个
%符号，数清有几个占位符 - 确认传入参数个数是否匹配
- 逐个核对每个占位符的类型标识（
d、s、f等）与对应参数的实际运行时类型 - 特别注意自动装箱/拆箱边界：比如
Integer可用于%d，但Long不能直接用于%d（需用%ld）
安全写法建议
避免硬编码格式符与类型强耦合，可借助以下方式降低风险：
- 优先用
%s处理不确定类型的对象（它调用toString()，兼容性最强） - 对数字类型明确区分：
%d用于int/Integer，%ld用于long/Long，%f用于double/Double - 打印数组时不用
%s直接传int[]，改用Arrays.toString(arr)再格式化 - 复杂场景考虑用
MessageFormat（支持位置索引和类型宽松匹配）或现代日志框架（如 SLF4J 的占位符不校验类型）
一个典型修复示例
错误写法：
System.out.printf("编号：%d，名称：%s%n", "A001", "张三");这里 %d 对应的是字符串 "A001"，会立即抛出 IllegalFormatConversionException。
正确写法（根据语义选合适格式符）：
- 若“编号”本质是字符串：用
%s——System.out.printf("编号：%s，名称：%s%n", "A001", "张三"); - 若“编号”是整数：确保传整数 ——
System.out.printf("编号：%d，名称：%s%n", 1001, "张三");
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
