Spring MVC+Drools项目引入<mvc:annotation-driven/>后遇HTTP 500错误求助

背景与配置 #

我在Spring MVC 6和Drools 7的项目中，为了提供图片、CSS、JS等静态资源，添加了以下配置：

1. Spring MVC静态资源与注解驱动配置 #

<!-- 启用Spring MVC @Controller编程模型 -->
<mvc:annotation-driven />
<!-- 处理指向/resources/**的HTTP GET请求，高效提供${webappRoot}/resources目录下的静态资源 -->
<mvc:resources mapping="/resources/js/**" location="/resources/js/"/>

2. 组件扫描配置 #

<!-- 扫描应用基础包下的@Component并配置为Bean -->
<context:component-scan base-package = "package-name" />

问题现象 #

此前未配置第1项时，页面表单可正常加载；但引入mvc:annotation-driven和静态资源配置后，出现HTTP 500错误：

HTTP Status 500 - org.springframework.core.convert.ConversionFailedException: Failed to convert from type [java.lang.String] to type [int] for value 'null'; nested exception is java.lang.IllegalArgumentException: A null value cannot be assigned to a primitive type

我的疑问 #

• Q1) 此前未使用annotation-driven时功能正常，为何配置后出问题？
• Q2) 是否1和2两项配置均为必需？
• Q3) 仅用其中一项时表单页出现404，遗漏了什么？
• 额外疑问：控制台可见null无法赋值给原始类型的异常，为何仅原始类型触发该异常而String不会？

问题解答 #

Q1: 为什么加了mvc:annotation-driven就出问题了？ #

没加mvc:annotation-driven的时候，Spring MVC用的是默认的类型转换机制，这个机制对表单提交的空值处理比较宽松——比如表单里某个int类型的字段没填，它会偷偷给你塞个0，不会直接抛异常。

但一旦你启用了mvc:annotation-driven，Spring会启用更严格的ConversionService（默认是FormattingConversionService），这个转换服务会严格校验类型转换：原始类型（int、long、boolean这些）不能接受null值，因为Java里原始类型本身就不能存null。而之前的默认机制没做这么严格的校验，所以你没发现问题。

简单说：加了注解驱动后，类型转换的规则变严格了，之前隐藏的“表单空值对应原始类型”的问题就暴露出来了。

Q2: 两项配置是否都必需？ #

是的，但要看你的场景：

• context:component-scan：必须有，它负责扫描你的@Controller、@Service、@Component等注解类，把它们注册成Spring Bean，没有这个的话，你的控制器根本不会被Spring识别，自然处理不了请求。
• mvc:annotation-driven：如果要使用Spring MVC的注解式编程模型（比如@RequestMapping、@RequestParam这些），以及启用静态资源映射、类型转换、格式化等高级功能，就必须配置它。另外，静态资源的mvc:resources标签也需要依赖mvc:annotation-driven才能正常工作（因为它需要Spring MVC的DispatcherServlet来路由静态资源请求）。

所以这俩是互补的，缺一不可（除非你不用注解式开发，但现在几乎没人这么干了）。

Q3: 仅用其中一项时表单页404，遗漏了什么？ #

• 如果只加context:component-scan没加mvc:annotation-driven：Spring虽然扫描到了控制器，但没启用注解式请求映射的处理机制，DispatcherServlet没法把请求路由到你的控制器方法上，所以返回404。另外，静态资源也没法被正确映射，访问静态资源也会404。
• 如果只加mvc:annotation-driven没加context:component-scan：Spring没扫描到你的控制器类，根本没有处理请求的Bean，自然所有请求（包括表单页和静态资源）都会返回404。

额外疑问：为什么只有原始类型触发null转换异常，String不会？ #

这个是Java的基础特性决定的：

• String是引用类型，引用类型可以接受null值，所以Spring把表单里的空值（或者没提交的字段）转换成null给String类型的属性时，完全合法，不会报错。
• int、long这些是原始类型，它们在Java里没有null的概念，默认值是0（int）、0L（long）等，但Spring的严格转换服务不会自动给你补默认值——它会认为“你提交了null，但原始类型不能存null”，所以直接抛出转换异常。

快速修复建议 #

既然知道了原因，你可以这么快速解决问题：

1. 把实体类里的原始类型改成对应的包装类：比如把int age改成Integer age，这样就能接受null值了。
2. 或者在控制器方法的参数上添加@RequestParam(required = false, defaultValue = "0")，给空值指定默认值。

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