Thymeleaf2升级至3后SpEL空指针异常：非空对象值为null

核心问题定位 #

你遇到的SpELEvaluationException（EL1007E）本质是：Java调试中确认存在有效值的Map，在Thymeleaf模板遍历中被SpEL判定value为null，进而触发空指针类异常。结合Thymeleaf 3的特性变化，核心排查方向集中在SpEL解析规则变更、Spring WebFlow对象传递机制、JavaBean属性访问规范三个维度。

具体排查与解决步骤 #

1. 验证模板语法与JavaBean规范 #

Thymeleaf 3对SpEL的属性访问要求更严格，先确认两点：

• Map遍历语法：确保遍历Map时的变量是Entry类型，模板中标准写法应为：

  <th:block th:each="entry : ${sessionDTO.opAttendanceSchedule.scheduleMap}">
      <!-- 添加调试输出确认值状态 -->
      <div th:text="Key: ${entry.key}, Value非空: ${entry.value != null}"></div>
      <div th:text="Value类名: ${entry.value?.getClass().getName()}"></div>
  </th:block>
  

• Getter方法规范：检查scheduleMap的value对象中，scheduleHours对应的getter必须严格遵循JavaBean规范——方法名是getScheduleHours()，属性名与方法名的大小写完全匹配（比如属性是scheduleHours，不能写成schedulehours）。Thymeleaf 2可能容忍不规范的命名，但3会直接判定属性不存在。

2. 排查Spring WebFlow的代理/序列化问题 #

Spring WebFlow在传递对象时，会对持久化相关对象生成CGlib代理，Thymeleaf 3的SpEL无法穿透这类代理访问真实属性：

• 验证代理对象：在Java代码中获取真实对象，确认数据是否存在：

  OpAttendanceSchedule attendanceSchedule = sessionDTO.getOpAttendanceSchedule();
  if (AopUtils.isAopProxy(attendanceSchedule)) {
      // 获取代理后的真实对象
      OpAttendanceSchedule realObj = (OpAttendanceSchedule) ((Advised) attendanceSchedule).getTargetSource().getTarget();
      System.out.println(realObj.getScheduleMap().values()); // 确认真实对象的Map值存在
  }
  

• 解决方案：
  • 让OpAttendanceSchedule及内部对象实现Serializable接口，WebFlow会序列化对象而非生成代理；
  • 在WebFlow配置中关闭持久化上下文代理（如果业务允许）：

    <webflow:flow-executor id="flowExecutor">
        <webflow:flow-execution-attributes>
            <webflow:always-redirect-on-pause value="false"/>
            <webflow:persistence-context-proxy mode="NONE"/>
        </webflow:flow-execution-attributes>
    </webflow:flow-executor>
    

3. 检查Thymeleaf与WebFlow的版本兼容性 #

Thymeleaf 3需要搭配**Spring WebFlow 2.5.0+**版本，版本不兼容会导致对象传递时的解析异常：

• 确认依赖版本（以Maven为例）：

  <dependency>
      <groupId>org.springframework.webflow</groupId>
      <artifactId>spring-webflow</artifactId>
      <version>2.5.3.RELEASE</version>
  </dependency>
  

• 确保Thymeleaf配置中添加了WebFlow方言：

  @Bean
  public SpringTemplateEngine templateEngine() {
      SpringTemplateEngine engine = new SpringTemplateEngine();
      engine.setTemplateResolver(templateResolver());
      engine.addDialect(new SpringWebFlowDialect()); // 必须添加，否则WebFlow传递的对象无法被Thymeleaf识别
      return engine;
  }
  

4. 临时规避与验证 #

如果需要快速验证问题，可以在模板中使用SpEL的**空安全操作符?.**避免异常，同时确认属性是否能被访问：

<span th:text="${opScheduleMap.value?.scheduleHours}"></span>

如果添加后能正常显示值，说明问题是SpEL在评估时未正确处理代理对象的延迟加载，而Java调试时对象已完成初始化。

总结 #

大概率是以下某一原因导致：

1. Thymeleaf 3对JavaBean getter的严格校验，旧代码中存在不规范的属性命名；
2. Spring WebFlow的代理对象被SpEL判定为null，真实属性无法被访问；
3. Thymeleaf与WebFlow版本不兼容，导致对象传递解析失败。

按上述步骤逐一排查，基本能定位并解决问题。

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