Spring Boot集成Ehcache配置Key/Value时为何抛出ClassCastException？

核心原因 #

Hibernate 6的二级缓存并不是直接缓存实体对象本身，也不会用实体ID作为缓存Key：

• 缓存Key实际是Hibernate内部的BasicCacheKeyImplementation类，而非你配置的java.lang.Integer
• 缓存Value是Hibernate封装的StandardCacheEntryImpl类，这个类包含了实体状态、版本等元数据，而非直接存储EmailStatus实体对象

你看到的文档示例大多是**直接用Ehcache作为独立缓存（比如Spring Cache）**的场景，这类场景下确实需要指定Key/Value类型，但Hibernate二级缓存是通过JCache（JSR-107）适配层实现的，Hibernate会自行处理缓存键值的包装与序列化，所以手动指定类型会导致类型转换异常。

正确配置方式 #

移除Ehcache配置中的<key-type>和<value-type>，仅保留缓存别名与模板引用即可：

<?xml version="1.0" encoding="UTF-8"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns="http://www.ehcache.org/v3"
        xmlns:jsr107="http://www.ehcache.org/v3/jsr107"
        xsi:schemaLocation="http://www.ehcache.org/v3
                            http://www.ehcache.org/schema/ehcache-core.xsd">

    <cache-template name="default">
        <expiry>
            <ttl unit="seconds">600</ttl>
        </expiry>

        <resources>
            <heap>1000</heap>
            <offheap unit="MB">10</offheap>
        </resources>
    </cache-template>

    <cache alias="email-status-cache" uses-template="default">
        <!-- 无需指定key-type和value-type，交由Hibernate处理 -->
    </cache>
</config>

实体类的@Cache注解保持不变即可：

@Entity
@Access(AccessType.FIELD)
@org.hibernate.annotations.Cache(region = "email-status-cache", usage = CacheConcurrencyStrategy.NONSTRICT_READ_WRITE)
@Table(name = "email_status")
public class EmailStatus implements Serializable {
    // ... 实体字段与方法
}

额外注意事项 #

确保项目依赖配置正确（Spring Boot 3环境）：

<!-- pom.xml 示例 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-cache</artifactId>
</dependency>
<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-jcache</artifactId>
</dependency>
<dependency>
    <groupId>org.ehcache</groupId>
    <artifactId>ehcache</artifactId>
</dependency>

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