Quarkus应用中编写单元测试是否需要使用@QuarkusTest注解？

针对你的问题，直接给结论：纯单元测试场景完全不需要用@QuarkusTest，下面分情况讲适配的方案和特殊场景：

1. 纯隔离单元测试：用常规JUnit + Mock框架就够 #

如果你的测试目标是单独验证某个类的逻辑（比如Service、工具类），完全不需要Quarkus运行时或上下文，直接用JUnit配合Mockito这类Mock框架就行。这种方式速度极快，能彻底隔离依赖，完全符合单元测试的初衷。

举个实际例子，测试一个依赖Repository的UserService：

import org.junit.jupiter.api.Test;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import org.junit.jupiter.api.extension.ExtendWith;
import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.*;

@ExtendWith(MockitoExtension.class)
public class UserServiceTest {

    @Mock
    private UserRepository userRepository; // 模拟依赖的Repository

    @InjectMocks
    private UserService userService; // 把Mock注入到待测试类

    @Test
    void testCreateUser() {
        // 预设Mock行为
        User mockUser = new User("test@example.com");
        when(userRepository.save(any(User.class))).thenReturn(mockUser);

        // 执行测试方法
        User result = userService.createUser("test@example.com");

        // 验证结果和Mock调用
        assertEquals("test@example.com", result.getEmail());
        verify(userRepository, times(1)).save(any(User.class));
    }
}

2. 需要Quarkus基础功能？用@QuarkusUnitTest替代@QuarkusTest #

如果你的测试类依赖Quarkus的轻量级功能（比如@Inject依赖注入、配置读取、小型扩展），但又不想启动完整的Quarkus运行时，Quarkus专门提供了@QuarkusUnitTest注解——它会启动一个最小化的Quarkus上下文，支持核心DI和配置，但不会启动HTTP服务器、数据库连接池这类重型组件，速度比@QuarkusTest快很多。

比如测试一个读取配置的服务：

import io.quarkus.test.junit.QuarkusUnitTest;
import org.junit.jupiter.api.Test;
import javax.inject.Inject;
import static org.junit.jupiter.api.Assertions.assertEquals;

@QuarkusUnitTest
public class ConfigServiceTest {

    @Inject
    private ConfigService configService; // 依赖Quarkus的配置注入

    @Test
    void testConfigValue() {
        // 假设application.properties里配置了app.name=QuarkusDemo
        assertEquals("QuarkusDemo", configService.getAppName());
    }
}

3. 什么时候@QuarkusTest适合“类单元测试”场景？ #

严格来说，@QuarkusTest是为集成测试设计的，但如果你的“单元测试”需要依赖Quarkus的集成类组件（比如需要测试数据库操作、REST客户端调用，或者依赖Quarkus的消息队列扩展），手动Mock这些组件会非常麻烦，这时候用@QuarkusTest反而更高效——它会启动完整的Quarkus上下文，帮你自动管理这些集成组件的测试实例（比如用H2内存数据库替代真实数据库）。

不过要注意，这种场景下的测试已经偏向集成测试范畴，执行速度会比纯单元测试慢不少，所以只在确实需要时用。

总结选择原则 #

• 纯逻辑单元测试：JUnit + Mock框架，无Quarkus注解，最快最纯粹。
• 依赖Quarkus核心DI/配置：用@QuarkusUnitTest，轻量上下文，平衡功能和速度。
• 依赖Quarkus集成组件：用@QuarkusTest，适合需要真实集成环境的测试（虽偏向集成，但能减少Mock工作量）。

内容的提问来源于stack exchange，提问作者Sergio Agüero