Spring MVC自定义校验提示失效：ReloadableResourceBundleMessageSource不生效

我刚上手Spring MVC时也踩过这个坑！你现在遇到的问题是自定义校验错误提示没生效，依然显示Spring默认内容，咱们一步步排查解决：

1. 先修正MessageSource的ID（最常见的坑） #

Spring MVC默认会自动查找**id为messageSource**的MessageSource Bean，你当前配置的id是messages，Spring大概率识别不到它，所以直接用了内置的默认消息源。把配置改成这样：

<bean id="messageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
    <!-- 路径可以保留开头的/，确保对应WebContent/WEB-INF下的文件即可 -->
    <property name="basename" value="/WEB-INF/errormessages"/>
    <!-- 加上编码配置，避免后续加中文提示时出现乱码 -->
    <property name="defaultEncoding" value="UTF-8"/>
    <!-- 开发阶段设置缓存1秒，修改properties后无需重启就能看到效果 -->
    <property name="cacheSeconds" value="1"/>
</bean>

2. 确认校验消息键名的正确性 #

你写的Size.student.address这个键是符合规则的——Spring校验消息的命名规则就是注解名.模型类小写名称.字段名，这里对应你@ModelAttribute("student")里的名称，完全没问题。

3. 视图层要正确渲染错误消息 #

假设你用的是JSP视图，一定要用Spring的<form:errors>标签来显示错误，它会自动关联自定义的MessageSource获取提示内容。示例代码：

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>

<form:form modelAttribute="student" action="/frontend/getdetails.htm" method="get">
    <div>
        <label for="address">Address:</label>
        <form:input path="address" id="address"/>
        <!-- 这里会自动加载对应字段的自定义错误提示 -->
        <form:errors path="address" cssClass="error-text"/>
    </div>
    <button type="submit">Submit</button>
</form:form>

如果不用Spring表单标签，也可以用<spring:message>标签手动获取：

<%@ taglib prefix="spring" uri="http://www.springframework.org/tags" %>
<spring:message code="Size.student.address"/>

4. 显式配置校验器（可选，但能确保生效） #

如果上面的步骤还没解决问题，可以显式配置校验器，强制它关联咱们的自定义MessageSource：

<!-- 配置校验器，绑定到自定义消息源 -->
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
    <property name="messageSource" ref="messageSource"/>
</bean>

<!-- 让请求处理器适配器使用这个校验器 -->
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="webBindingInitializer">
        <bean class="org.springframework.web.bind.support.ConfigurableWebBindingInitializer">
            <property name="validator" ref="validator"/>
        </bean>
    </property>
</bean>

最后检查小细节 #

• 确认errormessages.properties文件确实在/SpringLearning_9dec/WebContent/WEB-INF/路径下，文件名没有拼写错误（比如是不是少写了一个s？）
• 如果是Linux环境，注意文件名和键名的大小写——Windows不敏感，但Linux环境下大小写不匹配会导致读取失败。

按照上面的步骤调整后，应该就能正常显示你的自定义校验提示了！

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