Spring Boot启动因DateFormat未设置触发空指针异常问题排查

核心结论 #

• 不是资源不足导致：资源不足一般引发OOM、文件句柄耗尽等异常，不会直接导致mvcProperties.getDateFormat()返回null触发空指针。
• 和Locale获取系统日期格式无关：Spring Boot的MvcProperties中dateFormat属性默认就是null，它不会主动从Locale读取系统日期格式——只有未配置spring.mvc.format.date时，这个值保持null状态。

空指针触发原因 #

WebMvcAutoConfiguration的mvcConversionService方法出现空指针，通常是以下情况：

• 自定义WebMvc配置破坏了原有逻辑：如果自定义了WebMvcConfigurer或相关扩展类，修改了ConversionService的构建逻辑，可能移除了原有的null安全校验；
• 所用Spring Boot版本存在bug：部分旧版本的自动配置代码中，未对dateFormat为null的场景做防护，直接调用其方法引发空指针。

修复方案 #

• 显式配置日期格式：在application.yml或application.properties中添加spring.mvc.format.date=yyyy-MM-dd（按需调整格式），强制为dateFormat赋值；
• 排查自定义配置：检查项目中自定义的WebMvc相关配置类，确认在处理日期格式转换时是否做了null判断；
• 升级Spring Boot版本：如果是版本bug导致，升级到2.7.x及以上的稳定版本，这类问题通常已被修复。

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