Spring Boot 中怎么对注入的 Bean 进行单元测试

夏伟大大_8888

夏伟大大_8888

2026-10-22

409人浏览

原创

spring boot单元测试关键在于验证业务逻辑而非容器注入,主流分两类:轻量级纯单元测试(@mockitotest+@injectmocks)和集成式测试(@springboottest+@mockbean),前者快且独立,后者适用于需spring上下文的场景。

spring boot 中怎么对注入的 bean 进行单元测试

Spring Boot 中对注入的 Bean 做单元测试,关键不是“测 Spring 容器是否注入成功”,而是验证该 Bean 的业务逻辑是否按预期工作——同时隔离它所依赖的其他 Bean。主流做法分两类:轻量级纯单元测试(不启动 Spring 上下文)和带上下文的集成式测试(启动最小 Spring 环境)。选哪种,取决于你测的是什么。

优先用 @MockitoTest + @InjectMocks 测 Service 层逻辑

这是真正意义上的单元测试:快、独立、只聚焦被测类自身行为。适用于 Service、Util、DTO 转换等无 Spring 特性依赖的组件。

  • 不加 @SpringBootTest,完全绕过 Spring 容器启动,毫秒级执行
  • 用 @Mock 声明依赖对象(如 UserRepository、RedisTemplate)
  • 用 @InjectMocks 创建被测对象,并自动把 @Mock 注入进去
  • 手动调用方法、断言返回值、verify 交互次数

示例:

  @ExtendWith(MockitoExtension.class)
  class UserServiceTest {
    @Mock
    private UserRepository userRepository;
    @Mock
    private EmailService emailService;
    @InjectMocks
    private UserServiceImpl userService;

    @Test
    void shouldSendWelcomeEmailWhenUserCreated() {
      when(userRepository.save(any())).thenReturn(new User(1L, "Alice"));
      userService.createUser("Alice", "a@example.com");
      verify(emailService).sendWelcomeEmail("a@example.com");
    }

用 @SpringBootTest + @MockBean 测需要 Spring 上下文的场景

当你必须测 AOP 切面、@Transactional、@Async、@Scheduled、@EventListener 或自动装配逻辑时,就得启动 Spring 环境。此时用 @MockBean 替换真实 Bean,避免连数据库或调外部服务。

JavaStoryDevelop
JavaStoryDevelop

你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在

下载
  • @MockBean 会替换 Spring 容器中同类型的 Bean,所有未 stub 的方法默认返回 null 或基本类型默认值
  • 配合 @Autowired 获取被测 Bean(通常是 Controller 或加了注解的 Service)
  • 适合验证 Web 层入口、事务边界、配置生效情况等

示例:

  @SpringBootTest
  @AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE) // 不动真实库
  class UserControllerTest {
    @Autowired
    private UserController userController;
    @MockBean
    private UserService userService;

    @Test
    void shouldReturnUserById() {
      when(userService.findById(1L)).thenReturn(new User(1L, "Bob"));
      ResponseEntity result = userController.getUser(1L);
      assertThat(result.getBody().getName()).isEqualTo("Bob");
    }

@SpyBean 用于部分打桩 + 真实调用混合场景

当你要保留某个 Bean 的大部分真实行为(比如真实查库),但只想拦截其中一两个方法做定制返回(比如 mock 某个耗时的远程调用),就用 @SpyBean。

  • 它包装真实 Bean,未 stub 的方法仍走原实现
  • stub 时必须用 doReturn(...).when(spy).method(),不能用 when().thenReturn()(否则可能触发真实方法)
  • 常见于测试 Repository 或 FeignClient 的部分降级逻辑

示例:

  @SpringBootTest
  class OrderServiceTest {
    @Autowired
    private OrderService orderService;
    @SpyBean
    private PaymentClient paymentClient;

    @Test
    void shouldProcessOrderEvenIfPaymentFails() {
      doThrow(new RuntimeException("timeout")).when(paymentClient).charge(any());
      OrderResult result = orderService.placeOrder(new Order());
      assertThat(result.getStatus()).isEqualTo("PENDING_PAYMENT");
    }

避坑要点

  • 别在单元测试里写 @SpringBootTest + @Transactional —— 这是集成测试套路,启动慢、易受环境干扰
  • @Mock 和 @MockBean 不要混用:前者是 Mockito 原生,后者是 Spring Boot 提供的容器级模拟
  • Controller 层测试优先用 @WebMvcTest,它只加载 Web 相关 Bean,比 @SpringBootTest 更轻量
  • 确保测试类路径下没有意外激活的 profile(如 test.yml 写错导致连真实 Redis)

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2611

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

477

25

spring boot框架优点
spring boot框架优点

spring boot框架的优点有简化配置、快速开发、内嵌服务器、微服务支持、自动化测试和生态系统支持。本专题为大家提供spring boot相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.05

631

5

spring框架有哪些
spring框架有哪些

spring框架有Spring Core、Spring MVC、Spring Data、Spring Security、Spring AOP和Spring Boot。详细介绍:1、Spring Core,通过将对象的创建和依赖关系的管理交给容器来实现,从而降低了组件之间的耦合度;2、Spring MVC,提供基于模型-视图-控制器的架构,用于开发灵活和可扩展的Web应用程序等。

2023.10.12

1455

7

Java Spring Boot开发
Java Spring Boot开发

本专题围绕 Java 主流开发框架 Spring Boot 展开,系统讲解依赖注入、配置管理、数据访问、RESTful API、微服务架构与安全认证等核心知识,并通过电商平台、博客系统与企业管理系统等项目实战,帮助学员掌握使用 Spring Boot 快速开发高效、稳定的企业级应用。

2025.08.19

5006

10

Java Spring Boot 4更新教程_Java Spring Boot 4有哪些新特性
Java Spring Boot 4更新教程_Java Spring Boot 4有哪些新特性

Spring Boot 是一个基于 Spring 框架的 Java 开发框架,它通过 约定优于配置的原则,大幅简化了 Spring 应用的初始搭建、配置和开发过程,让开发者可以快速构建独立的、生产级别的 Spring 应用,无需繁琐的样板配置,通常集成嵌入式服务器(如 Tomcat),提供“开箱即用”的体验,是构建微服务和 Web 应用的流行工具。

2025.12.22

436

5

Java Spring Boot 微服务实战
Java Spring Boot 微服务实战

本专题深入讲解 Java Spring Boot 在微服务架构中的应用,内容涵盖服务注册与发现、REST API开发、配置中心、负载均衡、熔断与限流、日志与监控。通过实际项目案例(如电商订单系统),帮助开发者掌握 从单体应用迁移到高可用微服务系统的完整流程与实战能力。

2025.12.24

640

18

Spring Boot企业级开发与MyBatis Plus实战
Spring Boot企业级开发与MyBatis Plus实战

本专题面向 Java 后端开发者,系统讲解如何基于 Spring Boot 与 MyBatis Plus 构建高效、规范的企业级应用。内容涵盖项目架构设计、数据访问层封装、通用 CRUD 实现、分页与条件查询、代码生成器以及常见性能优化方案。通过完整实战案例,帮助开发者提升后端开发效率,减少重复代码,快速交付稳定可维护的业务系统。

2026.02.11

385

24

Kotlin协程编程与Spring Boot集成实践
Kotlin协程编程与Spring Boot集成实践

本专题围绕 Kotlin 协程机制展开,深入讲解挂起函数、协程作用域、结构化并发与异常处理机制,并结合 Spring Boot 展示协程在后端开发中的实际应用。内容涵盖异步接口设计、数据库调用优化、线程资源管理以及性能调优策略,帮助开发者构建更加简洁高效的 Kotlin 后端服务架构。

2026.02.12

371

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习