Spring MVC（JavaConfig配置）JUnit测试无法自动装配DAO类求助

看起来你遇到的问题很典型——当用@EnableWebMvc配置的Spring MVC项目做JUnit测试时，自动装配DAO类会抛出异常。核心原因在于Web层配置和持久化层配置的边界没理清，以及JUnit测试上下文没有正确加载DAO所需的依赖Bean（比如数据源、Hibernate SessionFactory、事务管理器等）。下面一步步给你解决思路：

1. 先理清配置类的职责（最佳实践） #

首先建议把你的配置按分层拆分，避免Web配置和持久化配置混在一起，这能从根源减少测试时的上下文加载问题：

拆分后的配置类示例 #

① WebMvc配置类（仅负责Web层）

这个类只处理Spring MVC的Web相关逻辑，不要包含DAO或数据源的配置：

@Configuration
@EnableWebMvc
@ComponentScan(basePackages = "com.yourproject.controller") // 只扫Controller包
public class WebMvcConfig implements WebMvcConfigurer {
    // 这里放视图解析器、静态资源映射等Web相关配置
}

② Hibernate/持久化配置类（负责DAO依赖）

单独抽离出数据源、Hibernate、事务管理的配置，专门用来初始化DAO所需的环境：

@Configuration
@EnableTransactionManagement
@ComponentScan(basePackages = "com.yourproject.dao") // 扫描DAO所在包
@PropertySource("classpath:db.properties") // 加载数据库配置文件
public class PersistenceConfig {

    @Autowired
    private Environment env;

    // 配置数据源
    @Bean
    public DataSource dataSource() {
        DriverManagerDataSource dataSource = new DriverManagerDataSource();
        dataSource.setDriverClassName(env.getProperty("jdbc.driver"));
        dataSource.setUrl(env.getProperty("jdbc.url"));
        dataSource.setUsername(env.getProperty("jdbc.username"));
        dataSource.setPassword(env.getProperty("jdbc.password"));
        return dataSource;
    }

    // 配置Hibernate SessionFactory
    @Bean
    public LocalSessionFactoryBean sessionFactory() {
        LocalSessionFactoryBean sessionFactory = new LocalSessionFactoryBean();
        sessionFactory.setDataSource(dataSource());
        sessionFactory.setPackagesToScan("com.yourproject.model"); // 扫描实体类包
        sessionFactory.setHibernateProperties(hibernateProps());
        return sessionFactory;
    }

    // Hibernate属性配置
    private Properties hibernateProps() {
        Properties props = new Properties();
        props.put("hibernate.dialect", env.getProperty("hibernate.dialect"));
        props.put("hibernate.show_sql", env.getProperty("hibernate.show_sql"));
        return props;
    }

    // 配置事务管理器
    @Bean
    public HibernateTransactionManager transactionManager() {
        HibernateTransactionManager txManager = new HibernateTransactionManager();
        txManager.setSessionFactory(sessionFactory().getObject());
        return txManager;
    }
}

③ WebAppInitializer（启动类）

这个类只需要加载Web和持久化的根配置，不需要在测试中直接使用：

public class WebAppInitializer implements WebApplicationInitializer {
    @Override
    public void onStartup(ServletContext servletContext) throws ServletException {
        AnnotationConfigWebApplicationContext rootContext = new AnnotationConfigWebApplicationContext();
        rootContext.register(PersistenceConfig.class, WebMvcConfig.class);
        
        servletContext.addListener(new ContextLoaderListener(rootContext));
        
        // 配置DispatcherServlet
        ServletRegistration.Dynamic dispatcher = servletContext.addServlet("dispatcher", new DispatcherServlet(rootContext));
        dispatcher.setLoadOnStartup(1);
        dispatcher.addMapping("/");
    }
}

2. 修正JUnit测试类的上下文配置 #

测试DAO时，不需要加载Web层的@EnableWebMvc配置，只需要加载持久化配置类即可。同时要确保测试类启用Spring的测试支持：

@RunWith(SpringJUnit4ClassRunner.class) // 启用Spring测试运行器
@ContextConfiguration(classes = {PersistenceConfig.class}) // 仅加载持久化配置
public class YourDAOTest {

    @Autowired
    private YourDAO yourDAO; // 现在应该能正常注入了

    @Test
    public void testFetchDataFromDB() {
        // 编写你的DAO测试逻辑，比如调用yourDAO的方法验证数据
        List<YourModel> data = yourDAO.getAllData();
        assertNotNull(data);
    }
}

3. 常见异常的排查点 #

如果还是报错，可以从这几个方向检查：

• NoSuchBeanDefinitionException：
  • DAO类有没有加@Repository注解？
  • PersistenceConfig的@ComponentScan有没有包含DAO所在的包？
  • 测试类的@ContextConfiguration有没有正确指定PersistenceConfig？
• 数据源/Hibernate初始化异常：
  • db.properties文件是否放在src/main/resources下，配置项是否正确？
  • 数据库服务是否正常启动，连接信息（URL、用户名、密码）是否正确？
  • sessionFactory的setPackagesToScan是否包含实体类所在的包？

内容的提问来源于stack exchange，提问作者Jahidul Islam Khan