Kotlin Spring Boot中Thymeleaf表单绑定Bean属性读取异常排查

错误核心：Bean property 'contracts[0].conid' is not readable or has an invalid getter method，说明Spring无法正确访问contracts列表中元素的conid属性，主要原因集中在数据类设计和Thymeleaf模板写法上：

1. 集合类型不兼容：Kotlin的List是只读集合，Spring数据绑定需要可写集合（如MutableList）才能正常访问和修改集合元素
2. 不必要的类继承：ContractForm继承Contract会导致属性路径混淆，Spring无法正确解析嵌套属性
3. Thymeleaf模板语法冲突：同时使用th:field和th:name/th:value会覆盖自动生成的属性，引发解析错误

1. 修正ContractForm数据类 #

改用可写集合类型，移除多余继承：

// 使用MutableList替代List，确保Spring可以绑定集合元素
data class ContractForm(var contracts: MutableList<Contract>? = mutableListOf())

同时确保Contract类的属性为可变类型（var），保证Spring能访问getter/setter：

data class Contract(
    var conid: String?,
    var symbol: String?,
    var secType: String?,
    var currency: String?,
    var primaryExch: String?
)

2. 简化Thymeleaf模板代码 #

移除重复的th:name和th:value，仅保留th:field自动处理属性绑定：

<form th:action="@{/search/save}" method="POST" th:object="${form}">
    <fieldset>
        <input type="submit" id="submitButton" th:value="Save">
        <table>
            <tr>
                <th>conid</th>
                <th>Symbol</th>
                <th>type</th>
                <th>Currency</th>
                <th>Primary ex.</th>
                <th>save</th>
            </tr>
            <tr th:each="contract, itemStat : *{contracts}">
                <td><input type="text" th:field="*{contracts[__${itemStat.index}__].conid}" /></td>
                <td><input type="text" th:field="*{contracts[__${itemStat.index}__].symbol}" /></td>
                <td><input type="text" th:field="*{contracts[__${itemStat.index}__].secType}" /></td>
                <td><input type="text" th:field="*{contracts[__${itemStat.index}__].currency}" /></td>
                <td><input type="text" th:field="*{contracts[__${itemStat.index}__].primaryExch}" /></td>
            </tr>
        </table>
    </fieldset>
</form>

3. 完善POST接收接口 #

在控制器中添加接收表单数据的POST方法：

@PostMapping("/search/save")
fun saveContracts(@ModelAttribute("form") contractForm: ContractForm): String {
    // 处理保存逻辑
    println("Received contracts: ${contractForm.contracts}")
    return "redirect:/search"
}

• Kotlin中Spring数据绑定要求属性为var，集合必须是MutableList/ArrayList这类可写类型，只读List无法支持嵌套属性访问
• th:field会自动生成正确的name属性并填充value，无需手动设置，避免重复属性引发冲突
• 避免不必要的类继承，ContractForm作为表单载体不需要继承Contract，防止属性路径混淆

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