Hibernate使用AttributeConverter处理Map时出现No type name错误排查

这个错误的核心原因是实体属性类型与转换器泛型不匹配，导致Hibernate无法识别对应的类型映射：

你的实体类中定义的属性是Map<String, String> temp，但MyMapConverter实现的是AttributeConverter<HashMap<String, String>, String>——泛型参数是HashMap而非Map，Hibernate的类型系统无法将接口类型Map和具体实现类HashMap的转换器关联起来，进而抛出"No type name"的映射异常。

修复步骤 #

1. 修正转换器的泛型类型
   把转换器的泛型参数从HashMap改为Map，和实体属性的类型保持一致：

@Converter
public class MyMapConverter implements AttributeConverter<Map<String, String>, String> {
    @Override
    public String convertToDatabaseColumn(Map<String, String> attribute) {
        // 增加空值处理，避免NullPointerException
        if (attribute == null) {
            return null;
        }
        return attribute.toString();
    }

    @Override
    public Map<String, String> convertToEntityAttribute(String dbData) {
        // 实现完整的反序列化逻辑（示例代码，可根据实际需求优化）
        if (dbData == null || dbData.trim().isEmpty()) {
            return new HashMap<>();
        }
        Map<String, String> map = new HashMap<>();
        // 解析类似"{key1=value1, key2=value2}"格式的字符串
        String content = dbData.substring(1, dbData.length() - 1).trim();
        if (!content.isEmpty()) {
            String[] entries = content.split(", ");
            for (String entry : entries) {
                String[] keyValuePair = entry.split("=", 2);
                if (keyValuePair.length == 2) {
                    map.put(keyValuePair[0].trim(), keyValuePair[1].trim());
                }
            }
        }
        return map;
    }
}

2. 确保转换器被正确识别（可选优化）
   如果希望这个转换器自动应用到所有Map<String, String>类型的实体属性上，可以给@Converter注解加上autoApply = true：

@Converter(autoApply = true)
public class MyMapConverter implements AttributeConverter<Map<String, String>, String> {
    // ... 实现代码
}

当然你原来在属性上标注@Convert(converter = MyMapConverter.class)的方式也是有效的，只要泛型匹配就可以正常工作。

3. 优化数据库列类型（可选）
   由于Map转成的字符串可能长度较长，建议给@Column指定合适的列类型，比如：

@Column(columnDefinition = "TEXT")
@Convert(converter = MyMapConverter.class)
private Map<String, String> temp;

额外注意事项 #

原代码中convertToEntityAttribute方法的实现是缺失的，一定要补充完整的反序列化逻辑，否则从数据库读取数据时会抛出异常。示例中的解析逻辑只是基础实现，如果你需要更健壮的处理（比如支持值中包含=或, 的场景），建议使用JSON序列化库（比如Jackson）来完成Map和字符串的互转，这样更可靠。

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