Spring 报错：No bean class specified on bean definition 的原因与解决

一、错误现象

启动 Spring 容器时抛出异常：

复制代码

org.springframework.beans.factory.BeanCreationException: 
Error creating bean with name 'userBean' defined in class path resource [beans.xml]: 
No bean class specified on bean definition

Caused by: java.lang.IllegalStateException: 
No bean class specified on bean definition

错误堆栈指向 beans.xml 中的 userBean，容器在实例化这个 Bean 时失败。

二、错误含义

错误信息已经说得很清楚：beans.xml 中定义的 userBean 没有指定 class 属性。

Spring 容器在初始化时，会遍历所有 <bean> 定义并实例化它们。实例化的第一步是获取 Bean 的类信息。如果 <bean> 标签中缺少 class 属性，AbstractBeanDefinition.getBeanClass() 会抛出 IllegalStateException，容器随即取消刷新并抛出 BeanCreationException。

三、常见的错误写法

3.1 完全遗漏 class 属性

xml 复制代码

<!-- ❌ 错误：没有 class 属性 -->
<bean id="userBean">
    <property name="name" value="张三"/>
</bean>

3.2 class 属性值为空

xml 复制代码

<!-- ❌ 错误：class 为空字符串 -->
<bean id="userBean" class="">
    <property name="name" value="张三"/>
</bean>

3.3 class 属性拼写错误

xml 复制代码

<!-- ❌ 错误：属性名拼成了 clazz 或 classs -->
<bean id="userBean" clazz="com.example.User">
</bean>

3.4 类路径写错

xml 复制代码

<!-- ❌ 错误：类名拼写错误，或包路径不存在 -->
<bean id="userBean" class="com.example.Userr">
</bean>

虽然这种情况报的是 ClassNotFoundException 而不是 No bean class specified，但本质上也是 class 属性配置错误。

四、正确的写法

xml 复制代码

<!-- ✅ 正确：指定完整的类全限定名 -->
<bean id="userBean" class="com.example.entity.User">
    <property name="name" value="张三"/>
    <property name="age" value="25"/>
</bean>

如果类在包路径下，需要写完整的全限定名（包名 + 类名）：

xml 复制代码

<bean id="userBean" class="com.xie.spring.entity.User">
    <property name="name" value="张三"/>
</bean>

五、为什么会出现这个错误？

Spring 的 Bean 定义在 XML 中通过 <bean> 标签描述。<bean> 标签的 class 属性告诉 Spring 容器：这个 Bean 对应的 Java 类是哪一个。Spring 需要通过反射调用该类的构造方法来创建实例。

如果 class 属性缺失，Spring 无法确定要实例化哪个类，自然也就无法创建 Bean。

六、排查步骤

定位 beans.xml 文件 ：根据堆栈信息，文件位于 classpath 下（通常是 src/main/resources/beans.xml）
搜索 userBean ：找到 id="userBean" 的 <bean> 标签
检查 class 属性 ：
- 是否存在
- 是否为空
- 拼写是否正确
- 全限定名是否完整
确认对应的 Java 类存在 ：检查 com.xie.spring.entity.User（或实际类名）是否在项目中
确认类有默认构造方法：Spring 默认通过无参构造方法实例化 Bean

七、IDE 中的检测建议

在 IntelliJ IDEA 中编写 Spring XML 配置文件时，IDEA 会提供以下辅助：

<bean> 标签的 class 属性会自动补全类名
如果类路径不存在，IDEA 会标红提示
如果类没有默认构造方法，IDEA 会给出警告

如果 class 属性没有自动补全，说明类名或包路径写错了。

八、完整示例

Java 类：

java 复制代码

package com.xie.spring.entity;

public class User {
    private String name;
    private Integer age;
    
    public User() {}
    
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
}

beans.xml：

xml 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
           http://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean id="userBean" class="com.xie.spring.entity.User">
        <property name="name" value="张三"/>
        <property name="age" value="25"/>
    </bean>

</beans>

测试类：

java 复制代码

public class testFirstBean {
    @Test
    public void test() {
        ApplicationContext context = new ClassPathXmlApplicationContext("beans.xml");
        User user = context.getBean("userBean", User.class);
        System.out.println(user.getName());  // 张三
    }
}

九、总结

原因	表现	解决方案
缺少 `class` 属性	`No bean class specified`	在 `<bean>` 标签中添加 `class="全限定类名"`
`class` 为空字符串	同上	填写正确的类全限定名
`class` 属性拼写错误	IDEA 标红，运行报错	使用 IDEA 自动补全，避免手写
类路径错误	`ClassNotFoundException`	检查包路径和类名

这个错误的本质是 XML 配置不完整 。Spring 容器初始化 Bean 时，第一步就是通过 class 属性确定目标类。配置文件中每个 <bean> 标签都必须包含有效的 class 属性，否则容器在预实例化单例 Bean 时就会失败。养成使用 IDEA 自动补全 class 属性的习惯，这类错误基本可以避免。