IllegalFormatFlagsException 是因格式化字符串中出现不合法或互斥的标志组合而抛出的运行时异常，如 %-+d、%0+d、%-+s 等，需按类型约束与语义冲突原则修复。
IllegalFormatFlagsException 是 Java 在执行 String.format()、printf() 或 Formatter 时，因格式化字符串中出现了**不合法或互斥的标志组合**而抛出的运行时异常。它不涉及参数类型错配（那是 IllegalFormatConversionException），而是聚焦于 flags 本身的语义冲突——比如要求“左对齐”又要求“补零”，或者对字符串强行加“正号”。
哪些标志组合属于典型互斥？
Java 的格式化标志（flags）有明确的适用范围和排他规则。常见非法组合包括：
-
%-+d：左对齐（-）与显式符号（+）不能共存，因为+要求符号占位，而-会打乱对齐基准 -
%0+d：补零（0）与显式符号（+）互斥，补零只作用于数值宽度填充，符号需单独处理 -
% +d（空格 flag ++）：两者都用于控制正数前缀，语义重叠且不允许并列 -
%-+s：字符串不支持+标志，写出来就直接报错，哪怕参数是数字字符串也不行 -
%,+#f：千位分隔符（,）和+对浮点数虽可共存，但若误用于%s或%d等不支持该组合的转换符，也会触发
如何快速定位问题位置？
异常堆栈通常指向调用 format() 的那一行，但真正的问题藏在格式串内部。建议按顺序排查：
- 把整个格式字符串复制出来，逐个检查每个
%开头的占位符，提取其 flags 部分（即%后、转换符前的所有字符） - 对照 Java Formatter 官方 Flags 表，确认该 flags 组合是否被允许用于当前转换符（如
d、f、s） - 临时删掉所有 flags，只保留基础形式（如
%d、%s），再逐个加回，观察哪一步触发异常 - 注意转义：如果字符串里本意是要输出一个百分号
%，必须写成%%；否则会被当作格式起始，导致后续解析错位
修复原则：匹配类型 + 遵守语义约束
修复不是靠试错，而是依据两个硬约束：
-
类型决定可用 flags：整数类（
d,o,x）支持+、-、0、,；浮点类（f,e）支持+、-、,，但不支持0（补零对小数无意义）；字符串（s）只支持-、#（仅对某些格式有效）、+或0 -
语义不可并存：例如
-（左对齐）意味着内容靠左、空白补右，而0（补零）默认右对齐、零补左——二者逻辑冲突，JVM 直接拒绝 - 示例修正：
String.format("%-+d", 42)→ 改为String.format("%+d", 42)（要符号）或String.format("%-d", 42)（要左对齐）
容易踩坑的边界情况
有些场景看似合理，实则危险：
- JDK 版本差异：JDK 17 对非法 flags 更严格，JDK 8 可能静默忽略或行为不一致，升级后突然报错很常见
-
动态拼接格式串：日志框架、模板引擎中，格式字符串可能来自配置或用户输入。若其中含未转义的
%或非法 flag，异常堆栈不会指向你写的那行代码，而是在下游format()调用处爆发 -
混淆 MessageFormat：它用的是
{0,number}这类语法，不走 Formatter 规则，也不会抛IllegalFormatFlagsException。别把两套机制混着调试
