Map<Object1,Object2>表单提交异常：非String类型Key绑定问题

我之前也踩过这个坑！当Map的键从String改成自定义对象后，直接用th:name="${data.key}"只会提交对象的toString值，Spring没法自动把它转成你的自定义Key对象。下面给你两种可行的解决思路，你可以根据场景选：

方法一：用索引式绑定（最通用） #

这种方法不需要额外写转换器，完全靠Spring MVC的表单绑定机制来处理：

第一步：确保你的自定义Key类符合要求 #

假设你的自定义Key类叫CustomKey，有prop1和prop2两个属性，必须满足：

• 有无参构造器（Spring需要实例化对象）
• 给两个属性加上getter和setter（Spring要给属性赋值）
• 重写equals()和hashCode()，基于prop1和prop2来实现（Map依赖这两个方法识别键）

比如用Lombok简化的话：

@Data
@NoArgsConstructor
@AllArgsConstructor
public class CustomKey {
    private String prop1;
    private String prop2;

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        CustomKey customKey = (CustomKey) o;
        return Objects.equals(prop1, customKey.prop1) && Objects.equals(prop2, customKey.prop2);
    }

    @Override
    public int hashCode() {
        return Objects.hash(prop1, prop2);
    }
}

第二步：修改Thymeleaf页面的表单绑定 #

遍历Map的时候，不要直接用data.key作为name，而是把自定义Key的每个属性拆出来，用索引来绑定整个Map条目：

<form th:action="@{/submit}" method="post" th:object="${dataMap}">
    <!-- 遍历Map，iterStat用来获取索引 -->
    <div th:each="entry, iterStat : ${dataMap}">
        <!-- 隐藏域绑定Key的第一个属性 -->
        <input type="hidden" 
               th:name="|dataMap[${iterStat.index}].key.prop1|" 
               th:value="${entry.key.prop1}" />
        
        <!-- 隐藏域绑定Key的第二个属性 -->
        <input type="hidden" 
               th:name="|dataMap[${iterStat.index}].key.prop2|" 
               th:value="${entry.key.prop2}" />
        
        <!-- 绑定对应的Value，这里用文本框举例 -->
        <input type="text" 
               th:name="|dataMap[${iterStat.index}].value|" 
               th:value="${entry.value}" />
    </div>
    <button type="submit">提交</button>
</form>

第三步：控制器接收参数 #

直接用@ModelAttribute绑定整个Map就行：

@PostMapping("/submit")
public String handleSubmit(@ModelAttribute("dataMap") Map<CustomKey, YourValueClass> dataMap, Model model) {
    // 这里的dataMap已经正确组装了自定义Key和对应的Value
    model.addAttribute("result", dataMap);
    return "result-page";
}

方法二：自定义字符串转Key的转换器（适合简单场景） #

如果你的自定义Key属性不多，也可以写一个Converter，把表单提交的拼接字符串转换成CustomKey对象：

第一步：写Converter #

@Component
public class StringToCustomKeyConverter implements Converter<String, CustomKey> {
    @Override
    public CustomKey convert(String source) {
        // 假设表单提交的是用逗号分隔的prop1和prop2，比如"val1,val2"
        String[] parts = source.split(",");
        if (parts.length != 2) {
            throw new IllegalArgumentException("Invalid CustomKey format");
        }
        return new CustomKey(parts[0], parts[1]);
    }
}

第二步：修改Thymeleaf的name属性 #

把Key的两个属性拼接成一个字符串作为Map的键：

<form th:action="@{/submit}" method="post">
    <div th:each="entry : ${dataMap}">
        <input type="text" 
               th:name="|dataMap[${entry.key.prop1},${entry.key.prop2}]|" 
               th:value="${entry.value}" />
    </div>
    <button type="submit">提交</button>
</form>

第三步：控制器接收 #

和方法一一样，直接用@ModelAttribute绑定Map即可，Spring会自动用你写的Converter把字符串转成CustomKey。

注意事项 #

• 不管用哪种方法，一定要重写CustomKey的equals和hashCode，否则Spring没法正确匹配Map的键。
• 如果是复杂的自定义Key，优先用方法一，更稳妥；简单场景可以用方法二，代码更简洁。

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