Spring/Hibernate项目配置包扫描时出现Entity is not mapped错误如何解决

问题核心根源 #

你混淆了Spring组件扫描和Hibernate实体扫描两个完全独立的配置逻辑，两者作用范围完全不同，因此调整<context:component-scan>的包路径无法解决实体类is not mapped报错。
<context:component-scan>仅负责扫描识别@Controller/@Service/@Repository/@Component等Spring原生Bean注解，完全不处理JPA/Hibernate的@Entity注解，实体类的扫描需要单独配置Hibernate相关参数。

正确配置步骤 #

1. 修正Spring组件扫描配置 #

从你提供的包结构来看，base_package.de是所有业务代码的父包，Spring组件扫描直接指定父包即可，默认会递归扫描所有子包，无需单独罗列所有子包，更不能在包名外加单引号：

<context:component-scan base-package="base_package.de" />

同时确保配置中开启了注解驱动，否则@Autowired、请求映射等注解不会生效：

<mvc:annotation-driven />
<context:annotation-config />

2. 单独配置Hibernate实体扫描 #

在你项目中Hibernate SessionFactory的配置中，新增packagesToScan属性指定实体类所在包，示例如下（保留你原有配置中数据源、hibernate参数等内容即可）：

<bean id="sessionFactory" class="org.springframework.orm.hibernate5.LocalSessionFactoryBean">
    <property name="dataSource" ref="dataSource" />
    <!-- 新增这行配置，指定实体类所在包 -->
    <property name="packagesToScan" value="base_package.de.entity" />
    <property name="hibernateProperties">
        <props>
            <prop key="hibernate.dialect">org.hibernate.dialect.MySQL8Dialect</prop>
            <prop key="hibernate.show_sql">true</prop>
            <!-- 原有hibernate配置保留 -->
        </props>
    </property>
</bean>

如果你的项目用JPA的EntityManager配置，对应在LocalContainerEntityManagerFactoryBean中添加同样的packagesToScan属性即可。

其他报错排查 #

你把所有类放到同一个包后报找不到customerService的问题，按以下顺序检查：

• 确认@Service注解加在Service的实现类上，而非Service接口上
• 确认@Service、@Repository等注解的导入包为org.springframework.stereotype下的对应类
• 确认Customer实体类的@Entity注解导入包为javax.persistence.Entity或jakarta.persistence.Entity，而非其他同名类
• 确认HQL语句中的实体名和@Entity注解标注的类名完全一致（大小写敏感），如果自定义了@Entity(name="xxx")，需要和name属性值匹配

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