Spring WebFlow中下拉列表对象绑定失败问题求助

在Spring Boot控制器环境下，Thymeleaf表单可正常将下拉列表选中的Species对象绑定到Animal模型，但切换到Spring Boot WebFlow后绑定失败。Species的ID为UUID类型。

表单代码 #

<form id="registration-form" th:object="${animal}"
    th:action="${flowExecutionUrl}" method="post">
    <div class="row"><div class="col">
        <label for="species">Species</label> 
        <select th:value="*{species}" id="species" name="species" class="form-control">
            <option selected disabled value="">-Choose-</option>
            <option th:each="species : ${speciess}" 
                th:value="${species.id}" 
                th:text="${species.description}">
            </option>
        </select>
    </div></div>
    <div class="form-group row"><div class="col-sm-10">
        <button type="submit" class="btn btn-primary" name="_eventId_next">Next
        &raquo;</button>
    </div></div>
</form>

WebFlow配置 #

<on-start>
    <evaluate expression="animalServiceImpl.init()" result="flowScope.animal"/>
</on-start>

<view-state id="start" view="my/animal/new" model="flowScope.animal">
    <on-render>
        <evaluate expression="holdingServiceImpl.findAll()" result="requestScope.holdings"/>
        <evaluate expression="colorServiceImpl.findAll()" result="requestScope.colors"/>
        <evaluate expression="genderServiceImpl.findAll()" result="requestScope.genders"/>
        <evaluate expression="arrivalTypeServiceImpl.findAll()" result="requestScope.arrivalTypes"/>
        <evaluate expression="speciesServiceImpl.findAll()" result="requestScope.speciess"/>
        <evaluate expression="baitsTagsServiceImpl.findAll()" result="requestScope.baitsTags"/>
        <evaluate expression="customTagServiceImpl.findAll()" result="requestScope.customTags"/>
        <evaluate expression="breedServiceImpl.findAll()" result="requestScope.breeds"/>
    </on-render>
    <transition on="next" to="confirmation"/>
    <transition on="cancel" to="registrationCancelled" validate="false" bind="false" /> 
</view-state>

<view-state id="confirmation" view="my/animal/confirm" model="flowScope.animal">
    <transition on="back" to="start" />
    <transition on="submit" to="submitRegistration"/>
    <transition on="cancel" to="registrationCancelled" />
</view-state> 

错误信息 #

• 使用th:value="${species.id}"提交时，出现类型不匹配错误：

[TargetAccessError@ecf873b mapping = parameter:'species' -> species, code = 'typeMismatch', error = true, errorCause = org.springframework.binding.expression.ValueCoercionException: Value could not be converted to target class; is a suitable type converter registered?, originalValue = 'bd8e962f-b334-4599-af69-d10352399b50', mappedValue = [null]]

• 尝试将th:value改为${species}后，出现新错误：

, code = 'propertyNotFound', error = true, errorCause = org.springframework.binding.expression.PropertyNotFoundException: Property not found, originalValue = [null], mappedValue = [null]], [TargetAccessError@1745e0fe mapping = parameter:'species' -> species, code = 'typeMismatch', error = true, errorCause = org.springframework.binding.expression.ValueCoercionException: Value could not be converted to target class; is a suitable type converter registered?, originalValue = 'Species{id=bd8e962f-b334-4599-af69-d10352399b50, description='Sheep'}', mappedValue = [null]],

解决方案 #

Spring WebFlow的绑定机制与常规Spring MVC存在差异，针对UUID类型ID的对象绑定，需做以下调整：

1. 实现自定义类型转换器 #

WebFlow无法自动将UUID字符串转换为Species对象，需编写Converter<String, Species>完成转换：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;
import java.util.UUID;

@Component
public class StringToSpeciesConverter implements Converter<String, Species> {

    private final SpeciesServiceImpl speciesService;

    public StringToSpeciesConverter(SpeciesServiceImpl speciesService) {
        this.speciesService = speciesService;
    }

    @Override
    public Species convert(String source) {
        if (source == null || source.isEmpty()) {
            return null;
        }
        return speciesService.findById(UUID.fromString(source));
    }
}

若使用XML配置WebFlow，需将转换器注册到WebFlow的转换服务中：

<flow:flow-builder-services id="flowBuilderServices" conversion-service="conversionService"/>

<bean id="conversionService" class="org.springframework.binding.convert.service.DefaultConversionService">
    <constructor-arg>
        <set>
            <ref bean="stringToSpeciesConverter"/>
        </set>
    </constructor-arg>
</bean>

2. 调整表单绑定方式 #

将<select>的th:value替换为th:field，Thymeleaf会自动处理选中状态和绑定逻辑，同时保留th:value="${species.id}"传递UUID：

<select th:field="*{species}" id="species" class="form-control">
    <option selected disabled value="">-Choose-</option>
    <option th:each="species : ${speciess}" 
            th:value="${species.id}" 
            th:text="${species.description}">
    </option>
</select>

3. 简化WebFlow模型配置 #

view-state的model属性可直接写变量名animal，无需指定flowScope.animal：

<view-state id="start" view="my/animal/new" model="animal">
    <!-- 其余配置保持不变 -->
</view-state>

原理说明 #

常规Spring MVC会通过Converter/Formatter自动完成ID到对象的转换，但WebFlow的绑定系统需要显式注册转换器；使用th:field能让Thymeleaf生成符合WebFlow绑定要求的表单属性，避免手动配置的偏差。

内容的提问来源于stack exchange，提问作者Patrick Andrew Jansen