Mock CloudStorageService时s3Client未初始化问题及正确Mock方法

你遇到的核心问题是Mock对象未被正确配置或注入，导致实际执行了CloudStorageService的真实方法——而真实方法依赖未初始化的s3Client，因此抛出异常。默认情况下，Mockito的Mock对象不会执行真实方法，只有在主动配置（如thenCallRealMethod()）或误用Spy时才会触发真实逻辑。

正确Mock的核心步骤（以Mockito为例） #

• 创建纯Mock实例，而非Spy或真实对象
• 将Mock实例正确注入到依赖它的SizingService中
• 对目标方法getSizeOfFirstMatchedObject进行Stub，指定返回值，彻底绕过真实逻辑

单元测试示例代码 #

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;

import static org.mockito.Mockito.when;
import static org.junit.jupiter.api.Assertions.assertEquals;

@ExtendWith(MockitoExtension.class)
public class SizingServiceTest {

    // 创建CloudStorageService的Mock实例，默认不执行真实方法
    @Mock
    private CloudStorageService cloudStorageService;

    // 自动将Mock实例注入到SizingService中
    @InjectMocks
    private SizingService sizingService;

    @Test
    public void testCalculateSize() {
        // 为目标方法Stub返回值，参数可根据实际情况用any()匹配
        long expectedSize = 1024L;
        when(cloudStorageService.getSizeOfFirstMatchedObject(/* 传入对应参数，或用any() */))
                .thenReturn(expectedSize);

        // 调用SizingService的业务方法
        long actualSize = sizingService.calculateSize();

        // 验证结果符合预期
        assertEquals(expectedSize, actualSize);
    }
}

常见错误排查 #

1. 误用@Spy替代@Mock：Spy会默认执行真实方法，仅Stub的方法会被替换。如果用了@Spy且未StubgetSizeOfFirstMatchedObject，就会触发真实逻辑导致异常。
2. 注入失败：如果SizingService是通过new手动创建的，而非依赖注入，Mock对象不会生效。必须确保SizingService的实例由测试框架管理（如@InjectMocks）。
3. 参数匹配不生效：如果Stub时指定的参数与实际调用的参数不匹配，Mockito会返回默认值（如null），但不会触发真实方法——若仍出现异常，大概率是其他配置问题。

Spring Boot集成测试场景 #

如果是在Spring Boot集成测试中，改用@MockBean将Mock对象注册到Spring容器，替换真实的CloudStorageService实例：

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.mock.mockito.MockBean;

import static org.mockito.Mockito.when;
import static org.junit.jupiter.api.Assertions.assertEquals;

@SpringBootTest
public class SizingServiceIntegrationTest {

    @MockBean
    private CloudStorageService cloudStorageService;

    @Autowired
    private SizingService sizingService;

    @Test
    public void testCalculateSize() {
        long expectedSize = 2048L;
        when(cloudStorageService.getSizeOfFirstMatchedObject(/* 参数匹配 */))
                .thenReturn(expectedSize);

        long actualSize = sizingService.calculateSize();
        assertEquals(expectedSize, actualSize);
    }
}

内容的提问来源于stack exchange，提问作者leoOrion