Spring Boot+Thymeleaf忽略校验注解自定义消息问题求助

问题现象 #

在Spring Boot 3.3.2 + Thymeleaf 3.1.2.RELEASE的MVC应用中，校验注解（如@Size）指定的自定义i18n消息键（如{ui.errors.nameLength}）未被Thymeleaf正确渲染，反而显示Size.test.name这类默认消息键。但控制台输出的BindingResult显示Spring已经正确将自定义键解析为对应的国际化消息。

根本原因 #

Thymeleaf的#fields.detailedErrors()方法默认会从Spring的Errors对象中获取原始的消息模板键（即注解里写的{ui.errors.nameLength}或框架默认的Size.test.name），而非Spring已经解析后的最终消息。这是因为Thymeleaf的Spring集成模块默认会尝试自行调用消息解析器处理这些键，若配置不当就会 fallback 到默认的消息键格式。

解决方案 #

方案1：直接使用BindingResult中的已解析消息 #

放弃Thymeleaf的#fields工具类，直接遍历BindingResult中的错误对象，获取Spring已经解析好的消息：

修改Thymeleaf模板：

<ul>
    <li th:each="e : ${bindingResult.allErrors()}" th:class="${e.global}? globalerr : fielderr">
        <span th:text="${e.global}? '*' : ${e.field}">The field name</span> |
        <span th:text="${e.defaultMessage}">The error message</span>
    </li>
</ul>

同时在Controller中显式将bindingResult添加到Model：

@PostMapping("/test-post")
public String registerClub(@Valid @ModelAttribute("test") TestDTO test, BindingResult bindingResult, Model model) {
    model.addAttribute("bindingResult", bindingResult);
    System.out.println(bindingResult);
    return "test-form";
}

方案2：配置Thymeleaf禁用消息重新解析 #

通过配置SpringTemplateEngine，让Thymeleaf直接使用Spring已经解析好的消息，不再自行处理：

创建Thymeleaf配置类：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.thymeleaf.spring6.SpringTemplateEngine;
import org.thymeleaf.spring6.messageresolver.SpringMessageResolver;
import org.thymeleaf.templateresolver.ITemplateResolver;

@Configuration
public class ThymeleafConfig {

    @Bean
    public SpringTemplateEngine templateEngine(ITemplateResolver templateResolver) {
        SpringTemplateEngine engine = new SpringTemplateEngine();
        engine.setTemplateResolver(templateResolver);
        
        // 替换默认消息解析器，直接使用Spring上下文的已解析消息
        engine.setMessageResolver(new SpringMessageResolver() {
            @Override
            protected String resolveMessage(
                    final org.thymeleaf.context.ITemplateContext context,
                    final String key, final Object[] parameters) {
                return context.getApplicationContext()
                        .getMessage(key, parameters, key, context.getLocale());
            }
        });
        return engine;
    }
}

方案3：确认国际化资源配置正确性 #

确保你的国际化资源文件（如messages.properties）放在src/main/resources目录下，且包含对应的消息键：

ui.errors.required=This field is required
ui.errors.nameLength=The name must be between {min} and {max} characters.

Spring Boot默认会自动加载该路径下的资源文件，无需额外配置MessageSource。

补充说明 #

你提到的SpringValidatorAdapter.shouldRenderDefaultMessage()确实和消息渲染逻辑相关，该方法决定是否使用默认消息键。当Spring已经解析了自定义消息后，这个方法会返回false，但Thymeleaf的#fields工具类并没有直接复用这个结果，而是重新读取了原始的消息模板键，这就是导致控制台与页面显示不一致的核心原因。

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