SpringBoot集成Thymeleaf属性文件占位符未生效问题

当前写法和Thymeleaf国际化消息的解析规则不匹配，直接导致占位符被原样输出：

• Thymeleaf中#{...}引用的国际化消息，默认走Java MessageFormat规则做参数替换，仅会识别{数字}格式的位置占位符。你写在属性文件消息值里的${fileName}，不属于MessageFormat的占位符语法，会被当做普通字符串直接渲染，不会触发任何替换逻辑。
• 模板中引用国际化消息时，没有传入需要替换的动态参数，Thymeleaf没有可用的填充数据源。

1. 调整属性文件的占位符语法 #

将原配置里的${fileName}替换为MessageFormat支持的位置占位符{0}，修改后的配置内容：

signup.form.error.file.too.big=File {0} is too Big

2. 调整模板的消息引用逻辑，传入动态参数 #

在模板的国际化消息表达式后追加参数列表，将model中存储的fileName变量值作为替换参数传入，修改后的模板代码：

<li th:if="${fileToBig}" th:text="#{signup.form.error.file.too.big(${fileName})}" />

3. 常见异常排查 #

如果修改后渲染仍有问题，按以下顺序核对：

• 确认SpringBoot配置项spring.messages.basename正确指向了你的属性文件，没有路径、文件名不匹配导致消息未加载的问题
• 确认请求作用域内的fileToBig判断值、fileName属性正确存入了model，不存在变量为空取不到值的情况
• 确认属性文件编码为UTF-8，没有因为编码异常导致消息文本解析错误

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