Spring Boot循环显示错误时自定义实体属性显示名称

Hey there! No worries at all—we all start somewhere with Spring Boot 😊. Let's fix that field name display issue so your error messages feel more user-friendly.

最优雅的方案：使用MessageSource统一管理字段名称 #

这种方法能让你集中维护所有字段的友好名称，还能轻松支持多语言，是大型项目的首选。

步骤1：创建消息属性文件 #

在src/main/resources目录下创建messages_zh_CN.properties（默认会自动加载，若需多语言可搭配messages.properties作为 fallback），添加字段映射：

# 格式：[实体类小写名].[属性名] = 友好显示名称
user.username=用户名
user.email=电子邮箱
user.password=登录密码

步骤2：在实体类校验注解中引用 #

修改实体类的校验注解，用占位符关联消息文件中的字段名，让错误消息更规范：

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Email;

public class User {
    @NotBlank(message = "{user.username}不能为空")
    private String username;

    @Email(message = "{user.email}格式不正确")
    private String email;

    @NotBlank(message = "{user.password}不能为空")
    private String password;

    // 省略getter/setter方法
}

步骤3：修改Thymeleaf模板读取友好名称 #

将原来直接显示原始属性名的代码，改为从MessageSource动态获取友好名称：

<ul>
    <li th:each="e : ${#fields.detailedErrors()}" th:class="${e.global}? globalerr : fielderr">
        <span th:text="${e.global}? '*' : #{user.${e.fieldName}}">The field name</span>
        <span th:text="${e.message}">The error message</span>
    </li>
</ul>

这里#{user.${e.fieldName}}会动态拼接消息键，比如当e.fieldName为username时，就会读取到user.username对应的“用户名”。

快速方案：直接在注解中指定 #

如果是小型项目，不想配置消息文件，也可以直接在校验注解的message里写入友好字段名：

@NotBlank(message = "用户名不能为空")
private String username;

这种方式简单直接，但缺点是字段名称会重复出现在多个校验注解中，后期维护成本较高。

注意事项 #

• 确保项目已引入Validation Starter（Spring Boot Web Starter默认包含，若缺失可手动添加）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

• Spring Boot 3.x版本中，校验注解来自jakarta.validation.constraints包，而非旧版的javax.validation。

内容的提问来源于stack exchange，提问作者Trystan Lapinig-Wilcock