0

0

如何正确测试依赖自动注入对象的 Spring Service 类

碧海醫心

碧海醫心

发布时间:2026-01-03 12:29:19

|

260人浏览过

|

来源于php中文网

原创

如何正确测试依赖自动注入对象的 Spring Service 类

本文介绍在不启动 spring 容器的前提下,使用 mockito 对依赖 `@autowired` 外部服务的 spring service 进行单元测试的正确方法,重点解决因未手动注入 mock 导致的空指针异常问题。

在 Spring 应用中,@Autowired 字段注入仅在 Spring IoC 容器管理 Bean 的生命周期时生效(例如通过 @SpringBootTest 启动上下文)。而在纯单元测试(如使用 @ExtendWith(MockitoExtension.class))中,Spring 容器并未参与对象创建,因此 MyService 实例中的 externalService 字段保持为 null,直接调用会触发 NullPointerException。

正确的做法是:跳过 Spring 依赖注入机制,改用手动赋值方式将 Mock 对象注入目标 Service 实例。注意以下关键点:

  • ✅ 使用 @Mock 声明并初始化 ExternalService 的 Mock 实例;
  • ✅ 使用 new MyService() 构造原始实例(非 @Spy 或 @InjectMocks 的模糊代理);
  • ❌ 避免 Mockito.spy(new MyService()) 后未注入依赖——spy 仅包装原对象,不自动处理字段赋值;
  • ✅ 在测试方法内或 @BeforeEach 中,显式赋值 myService.externalService = externalService
  • ✅ 使用 Mockito.when(...).thenReturn(...) 定义 Mock 行为,推荐使用具体返回值(如 "mocked-response")而非 anyString()(后者在 thenReturn 中无效,应改为 thenReturn("test-result"))。

以下是修正后的完整示例代码:

Relayed AI
Relayed AI

一款AI驱动的视频会议工具,旨在帮助团队克服远程工作、繁忙的日程安排和会议疲劳。

下载
@ExtendWith(MockitoExtension.class)
class MyServiceTest {

    @Mock
    private ExternalService externalService;

    private MyService myService; // 不要在此处初始化

    @BeforeEach
    void setUp() {
        myService = new MyService(); // 创建真实实例
        myService.externalService = externalService; // 手动注入 Mock
    }

    @Test
    void methodToTest_Test() {
        // 定义 Mock 行为:避免使用 anyString() 作为返回值
        when(externalService.call("input")).thenReturn("mocked-response");

        // 执行被测方法
        String result = myService.methodToTest("input");

        // 断言
        assertThat(result).isEqualTo("mocked-response");
        verify(externalService).call("input");
    }
}

⚠️ 注意事项:

  • @InjectMocks 虽可自动注入 @Mock 字段,但对 private 字段需配合 @Spy 或反射,稳定性不如手动赋值清晰可控;
  • 若 MyService 构造函数依赖 ExternalService,建议重构为构造器注入(推荐),此时可直接在 new MyService(externalService) 中完成依赖传递,更符合测试友好与 Spring 最佳实践;
  • 切勿在 thenReturn(anyString()) 中使用 anyString()——它仅用于匹配参数,不能作为返回值,否则将返回 null,引发后续 NPE。

总结:脱离 Spring 上下文的单元测试,本质是“普通 Java 对象测试”,所有依赖必须显式提供。手动注入 Mock 是最直接、可靠且易于理解的方式,兼顾可读性与可维护性。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

149

2025.08.06

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

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

85

2026.01.26

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

249

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

967

2024.03.01

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

747

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

23

2025.12.06

空指针异常处理
空指针异常处理

本专题整合了空指针异常解决方法,阅读专题下面的文章了解更多详细内容。

23

2025.11.16

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

43

2026.02.28

Golang 工程化架构设计:可维护与可演进系统构建
Golang 工程化架构设计:可维护与可演进系统构建

Go语言工程化架构设计专注于构建高可维护性、可演进的企业级系统。本专题深入探讨Go项目的目录结构设计、模块划分、依赖管理等核心架构原则,涵盖微服务架构、领域驱动设计(DDD)在Go中的实践应用。通过实战案例解析接口抽象、错误处理、配置管理、日志监控等关键工程化技术,帮助开发者掌握构建稳定、可扩展Go应用的最佳实践方法。

38

2026.02.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4万人学习

C# 教程
C# 教程

共94课时 | 10.5万人学习

Java 教程
Java 教程

共578课时 | 75.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号