Spring Boot集成测试：无法Mock调用第三方API的内部方法

核心问题 #

1. Mock配置未关联到实际测试类：TestMock类单独配置了MockBean，但实际运行API测试的是ApplicationTests，这个类没有加载任何Mock配置，Spring容器中使用的是真实的ServiceHandler实例。
2. TestConfig配置错误冗余：TestConfig上标注了@SpringBootTest、@RunWith等测试类专属注解，不符合@TestConfiguration的使用规范；手动创建Mock Bean的方式不仅繁琐，还容易出现Bean覆盖冲突。

修复方案 #

方案一：直接在ApplicationTests中配置MockBean #

修改ApplicationTests，添加@MockBean并配置Mock行为，确保测试时容器使用Mock实例：

@RunWith(SpringRunner.class)
@SpringBootTest
@AutoConfigureMockMvc(addFilters = false) 
class ApplicationTests {
    
    private final Logger LOGGER = LoggerFactory.getLogger(ApplicationTests.class);
    
    @Autowired
    private MockMvc mockmvc;
    
    @Autowired
    private ObjectMapper objectMapper;

    @MockBean
    private ServiceHandler serviceHandler;

    @Before
    public void setup() {
        // 配置Mock方法返回预期值
        Mockito.when(serviceHandler.cmsResponse()).thenReturn("testResult");
    }

    @Test
    void contextLoads() throws JsonProcessingException, Exception {
        AuhtmanReq auth = new AuhtmanReq();
        
        mockmvc.perform(post("/api/test/")
                .contentType(MediaType.APPLICATION_JSON)
                .content(objectMapper.writeValueAsString(auth)));           
        
        // 可选：验证Mock方法是否被调用
        Mockito.verify(serviceHandler, Mockito.times(1)).cmsResponse();
    }
}

方案二：修复TestConfig并启用测试Profile #

1. 修正TestConfig，移除冗余注解并提前配置Mock行为：

@TestConfiguration
@Profile("test")
public class TestConfig {
    
    @Bean
    public ServiceHandler serviceHandler() {
        ServiceHandler mockService = Mockito.mock(ServiceHandler.class);
        Mockito.when(mockService.cmsResponse()).thenReturn("testResult");
        return mockService;
    }
}

2. 在ApplicationTests上添加@ActiveProfiles("test")，让Spring加载测试环境的配置：

@RunWith(SpringRunner.class)
@SpringBootTest
@AutoConfigureMockMvc(addFilters = false)
@ActiveProfiles("test")
class ApplicationTests {
    // 原有代码不变，此时容器中的ServiceHandler为Mock实例
}

1. 区分单元测试与集成测试 #

• 单元测试：仅测试业务逻辑时，无需启动完整Spring容器，用Mockito直接Mock依赖：

@ExtendWith(MockitoExtension.class)
class TokenGenerationTest {
    @InjectMocks
    private TokenGeneration tokenGeneration;
    
    @Mock
    private ServiceHandler serviceHandler;
    
    @Test
    void testTokenGenerate() {
        Mockito.when(serviceHandler.cmsResponse()).thenReturn("testResult");
        AccessToken_VO result = tokenGeneration.tokengnerate(new AuhtmanReq());
        
        // 验证业务逻辑结果及方法调用
        Mockito.verify(serviceHandler).cmsResponse();
    }
}

• 集成测试：测试API完整流程时，用@MockBean替换真实Bean，既保留Spring容器上下文，又避免外部调用。

2. 抽象外部调用接口 #

将第三方API调用封装为独立接口，遵循依赖倒置原则，后续替换实现或Mock会更灵活：

// 定义接口
public interface ThirdPartyService {
    String getCmsResponse();
}

// 实现类
@Service
public class ThirdPartyServiceImpl implements ThirdPartyService {
    @Override
    public String getCmsResponse() {
        StringEntity jsonEntity = new StringEntity("Hello", ContentType.create("application/json"));
        return send(jsonEntity,"Service","url","reqmsgid");
    }
    
    // send方法逻辑...
}

修改TokenGeneration依赖ThirdPartyService接口，测试时Mock该接口即可，无需关注具体实现细节。

3. 优先使用@MockBean #

@MockBean是Spring Boot专为测试提供的注解，会自动替换容器中同类型的Bean为Mockito Mock实例，无需手动处理Bean注册，比自定义TestConfig更简洁、不易出错。

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