添加Hibernate@Cache注解后Eclipse CDI构建报错及代码提示失效问题

1. 调整CDI扫描范围，排除实体类 #

由于bean-discovery-mode="all"会扫描项目中所有类，包括带有Hibernate专属注解的实体类，CDI构建器无法识别这类非标准Java EE注解，进而触发报错。修改beans.xml，将实体类所在包从CDI扫描范围中排除：

<beans xmlns="http://xmlns.jcp.org/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/beans_2_0.xsd"
       bean-discovery-mode="all">
    <scan>
        <exclude name="com.yourpackage.entity.*"/>
    </scan>
</beans>

实体类无需作为CDI bean存在，排除后CDI构建器不会处理这些类，避免注解解析冲突。

2. 给实体类添加@Vetoed注解 #

如果不想修改全局扫描范围，直接在实体类上添加javax.enterprise.inject.Vetoed注解，明确告知CDI容器不要将该类识别为CDI bean：

import javax.persistence.Entity;
import javax.enterprise.inject.Vetoed;
import org.hibernate.annotations.Cache;
import org.hibernate.annotations.CacheConcurrencyStrategy;

@Entity
@Vetoed
@Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
public class YourEntity {
    // 实体类代码
}

这样CDI构建器会跳过该类的扫描，不会因Hibernate注解触发报错。

3. 验证JBoss Tools与Eclipse的版本兼容性 #

当前使用的JBoss Tools 4.29.1搭配Eclipse 2024-06可能存在版本适配问题，尝试升级JBoss Tools到对应Eclipse版本的最新稳定版，或者降级到官方推荐的兼容版本，确保CDI构建器能正确处理第三方框架注解。

4. 检查项目JPA配置与依赖 #

在Eclipse中确认项目JPA配置正确：

• 右键项目 → Properties → Project Facets → JPA → 点击「Configure JPA...」
• 确保「Platform」选择Hibernate 5.6，且Hibernate核心jar包完整引入，无缺失或重复依赖。
  同时检查项目Build Path，保证Hibernate注解相关jar（如hibernate-core）在编译路径中。

5. 清理重建项目 #

构建缓存异常也可能引发此类问题，执行以下操作：

• 右键项目 → Clean... → 选择目标项目执行清理
• 若使用Maven，右键项目 → Maven → Update Project；否则手动刷新并重新构建
• 重启Eclipse，彻底清除缓存

报错本质：CDI构建器扫描到Hibernate专属的@Cache注解时，无法正确解析其元数据，导致内部JDT API调用出错。通过排除实体类的CDI扫描，即可规避该兼容性问题。

内容的提问来源于stack exchange，提问作者శ్రీ