Spring WebFlow中@ModelAttribute绑定下拉列表失效问题排查

我之前也碰到过Spring WebFlow和MVC里@ModelAttribute行为不一致的坑，结合你的场景，问题大概率出在WebFlow的生命周期和模型作用域的差异上——毕竟WebFlow是流程驱动的，和MVC的请求驱动模型完全不同。

咱们一步步拆解问题：

1. @ModelAttribute在WebFlow里的触发时机和MVC不一样 #

在Spring MVC中，每个请求到达控制器时，所有@ModelAttribute注解的方法都会先执行，把数据放到request域里供视图使用。但WebFlow不是这样：它的生命周期是绑定在流程实例上的，默认情况下，@ModelAttribute注解的方法只会在流程启动时执行一次。如果你的messages是动态数据（比如每次进入视图都需要刷新），或者你是在某个视图状态下才需要这个列表，那这个时机就完全不对了。

解决办法：在你的WebFlow配置文件中，给对应的视图状态添加on-entry动作，显式调用获取messages的方法，并把结果存入flowScope（WebFlow的核心作用域，在整个流程实例中有效）：

<view-state id="yourViewStateId" view="your-thymeleaf-page">
    <on-entry>
        <!-- 这里替换成你实际的控制器和方法名 -->
        <evaluate expression="messageController.getMessages()" result="flowScope.messages" />
    </on-entry>
</view-state>

这样每次进入这个视图状态时，都会重新加载messages并放到流程作用域里。

2. Thymeleaf表达式的作用域问题 #

WebFlow的EL上下文和MVC不太一样，直接用${messages}可能找不到变量——因为WebFlow的变量默认存在flowScope或requestScope里，而不是MVC里的request域。

解决办法：在Thymeleaf模板里明确指定作用域：

<select name="selectedMessage">
    <option th:each="msg : ${flowScope.messages}" 
            th:value="${msg.id}" 
            th:text="${msg.content}">
        默认选项
    </option>
</select>

如果你的数据是存在requestScope里（比如临时请求数据），就换成${requestScope.messages}。

3. 控制器的类型问题 #

如果你的@ModelAttribute方法是写在普通的@Controller里，而不是WebFlow专用的@FlowController（或者实现了FlowHandler），那WebFlow根本不会触发这个方法——因为WebFlow只会识别自己的流程控制器里的逻辑。

解决办法：要么把获取messages的方法移到你的Flow控制器里，要么就用上面说的<evaluate>标签直接调用普通控制器的方法（只要Spring能扫描到这个控制器就行）。

4. 检查WebFlow和Thymeleaf的集成配置 #

最后确认一下你的WebFlow配置有没有正确集成Thymeleaf，否则视图根本无法访问WebFlow的作用域变量。确保配置里有MvcViewFactoryCreator：

<flow:flow-builder-services id="flowBuilderServices" view-factory-creator="viewFactoryCreator" />

<bean id="viewFactoryCreator" class="org.springframework.webflow.mvc.builder.MvcViewFactoryCreator">
    <property name="viewResolvers" ref="thymeleafViewResolver" />
</bean>

这个配置会让WebFlow使用Thymeleaf作为视图解析器，同时把WebFlow的作用域变量暴露给Thymeleaf模板。

按照这几步调整后，下拉列表应该就能正常渲染了。

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