如何通过编程将Spring的NumberFormatException替换为友好提示文本？

这个问题本质是Spring在类型转换失败时抛出的TypeMismatchException导致的，默认错误信息确实不够友好。咱们可以通过以下几步轻松实现自定义的友好提示：

1. 配置自定义错误消息源 #

首先在Spring配置中添加一个MessageSource，用来加载咱们自定义的提示文本。比如在spring-servlet.xml里配置：

<bean id="messageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
    <property name="basename" value="classpath:messages"/>
    <property name="defaultEncoding" value="UTF-8"/>
</bean>

然后在src/main/resources下创建messages.properties文件，添加对应错误代码：

# 针对特定实体的特定字段（假设你的实体叫Device，属性是autoDischargeTime）
typeMismatch.device.autoDischargeTime=自动放电时间必须为数字！
# 通用Integer类型不匹配提示（全局生效）
typeMismatch.java.lang.Integer=输入必须为有效的数字！

这里的错误代码规则是typeMismatch.实体类名首字母小写.属性名，Spring会优先匹配最具体的规则，找不到才用通用提示。

2. 在JSP表单中渲染错误信息 #

确保页面引入Spring form标签库，然后在对应字段下方添加<form:errors>标签展示提示：

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

<form:form modelAttribute="yourEntity" action="/save" method="post">
    <div>
        <label>自动放电时间：</label>
        <form:input path="autoDischargeTime"/>
        <form:errors path="autoDischargeTime" cssClass="error-text"/>
    </div>
    <button type="submit">提交</button>
</form:form>

这样用户输入非数字内容时，自定义提示会自动显示在字段下方。

3. 控制器方法绑定结果检查 #

要确保控制器方法绑定BindingResult，这样Spring会把错误信息存入结果而非直接抛出异常：

@RequestMapping(value = "/save", method = RequestMethod.POST)
public String saveEntity(@ModelAttribute("yourEntity") YourEntity entity, 
                         BindingResult result, Model model) {
    // 先检查类型转换等错误
    if (result.hasErrors()) {
        return "your-form-page"; // 返回表单页展示错误
    }
    // 执行你的名称校验和保存逻辑
    if (validate(entity)) {
        // 保存实体
        return "success-page";
    } else {
        model.addAttribute("nameError", "名称已存在！");
        return "your-form-page";
    }
}

完成这些调整后，用户输入非数字内容时，就能看到你想要的友好提示了！

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