Spring Boot 3.0升级后含Kotlin List<Enum>的Entity无法启动

核心原因 #

这个问题是Spring Boot 3.x配套的Hibernate 6.x版本与Kotlin泛型字节码处理不兼容导致的。具体来说，Hibernate在解析AttributeConverter的泛型类型时，对Kotlin定义的List<自定义枚举>字段，反射获取到的类型是WildcardTypeImpl，而Hibernate预期的是ParameterizedType，从而触发类型转换异常。

为什么仅List会触发？ #

这和Kotlin编译泛型的字节码特性、Hibernate对不同类型的解析逻辑有关：

• List vs ArrayList：Kotlin中List是接口，编译后的泛型信息在反射时会被处理成带通配符的类型（WildcardTypeImpl）；而ArrayList是具体实现类，反射时能直接获取到明确的ParameterizedType，Hibernate可以正常解析。
• List vs List：String是Java核心类型，Hibernate对String的类型解析有专门的适配逻辑，不会走普通泛型类型的解析流程，因此不会触发这个转换错误。
• List vs List<数据类>：Kotlin数据类属于普通的引用类型，Hibernate解析其泛型时，反射得到的是标准的ParameterizedType，不存在通配符类型的转换问题。

补充说明 #

Spring Boot 2.7.5使用的是Hibernate 5.x，其泛型类型解析逻辑没有这么严格，或者对Kotlin的兼容性更好，所以之前不会出现这个问题。升级到Hibernate 6.x后，类型解析逻辑重构，对泛型类型的检查更严格，才暴露了这个Kotlin与Hibernate的兼容性问题。

临时规避写法示例：

// 替换原List<Enum>定义
var interactions: ArrayList<Interaction> = arrayListOf()

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