Spring Boot校验场景下messages.properties仅用{1}参数占位符不解析问题

该现象是Hibernate Validator与Spring MessageSource集成时的默认参数处理逻辑导致的：

• 解析内置校验约束（例如@Size）时，Hibernate Validator会按固定顺序构造传递给消息源的参数数组：数组下标0存储被校验字段的显示名称，下标1存储约束定义的min属性值，下标2存储约束定义的max属性值，与数字索引占位符{0}、{1}、{2}一一对应。
• Validator内置了参数裁剪规则：如果检测到当前消息模板中未出现占位符{0}，会自动移除参数数组的第一个元素（字段名）后再传给消息源。此时传入的参数数组首元素变为原来的下标1位置的值（即min值），而Spring MessageSource在做占位符替换时，若碰到索引超出当前参数数组长度的占位符，不会自动对齐调整索引，只会原样保留占位符文本，因此就出现了{1}未被解析、原样输出的现象。
• 当你在模板中新增{0}后，Validator识别到模板存在该占位符，就不会触发裁剪逻辑，会把完整的参数数组传过去，此时{1}正好对应min值，就能正常解析了。

方案1（推荐，零侵入）：使用命名占位符替代数字索引 #

Jakarta Validation规范本身支持直接引用约束定义的属性值作为占位符，完全不需要依赖数组索引。针对@Size类的约束，只需要把占位符替换为约束的属性名即可：

validation.title=At least {min} characters

这种写法的优势：

• 命名占位符的替换是在Validator预处理阶段完成的，在参数裁剪逻辑执行之前就已经替换完成，从根源上避免索引错位的问题
• 模板可读性更强，后续调整约束参数顺序也不会引发解析错误
• 输出完全符合业务需求，不需要额外添加无意义的占位符

方案2：低改动兼容旧的数字索引写法 #

如果项目历史代码量大，暂时没法批量把数字索引换成命名占位符，可以利用Validator的检测规则：在模板中放置一个被转义的{0}占位符，让Validator识别到模板存在该占位符、不触发参数裁剪，同时通过转义机制避免占位符参与最终的插值替换。
写法示例：

validation.title=At least {1} characters ''{0}''

注意：Spring MessageSource中两个连续单引号是转义符，被单引号包裹的占位符不会触发插值替换
该方案存在一定局限：转义的{0}会以字面文本形式保留在最终输出中，仅适合对输出格式精度要求不高的场景。如果对输出内容有严格要求，还是推荐优先使用方案1。

内容的提问来源于stack exchange，提问作者alx