如何为调用第三方HTTP API的应用编写无需访问服务器的HTTP404单元测试用例？

嘿，这个问题问到点子上了！要写一个完全不依赖真实服务器的404单元测试，核心思路就是用**Mock（模拟）**替代真实的HTTP客户端，让它直接返回我们预设的404响应——毕竟我们要测的是自己代码对404的处理逻辑，而不是第三方API能不能正常跑。

我拿Python（结合unittest和unittest.mock）举个直观的例子，其他OOP语言（比如Java用Mockito、C#用Moq）的思路完全一致，最后我也会补个Java版的简化示例。

第一步：先写要测试的业务代码（依赖注入是关键） #

首先我们的业务类要支持依赖注入——别把HTTP客户端硬编码在类里，而是通过构造函数传进来，这样测试时才能轻松替换成Mock对象：

import requests  # 真实的HTTP客户端，测试时会被Mock掉

class ThirdPartyApiClient:
    def __init__(self, http_client=None):
        # 依赖注入：如果没传客户端，就用真实的requests；测试时传Mock
        self.http_client = http_client or requests

    def fetch_data(self, resource_id):
        url = f"https://third-party-api.com/resources/{resource_id}"
        response = self.http_client.get(url)
        
        # 我们要测试的核心逻辑：收到404时抛出指定异常
        if response.status_code == 404:
            raise ValueError("Resource not found (404)")
        # 其他状态码的处理逻辑...
        return response.json()

第二步：编写单元测试（完全不碰真实服务器） #

这里我们用unittest.mock创建一个假的HTTP客户端，让它直接返回404响应，然后验证我们的代码是否正确处理这个情况：

import unittest
from unittest.mock import Mock
from my_module import ThirdPartyApiClient  # 导入你的业务类

class TestThirdPartyApiClient(unittest.TestCase):
    def test_fetch_data_handles_404_correctly(self):
        # 1. 创建一个Mock的HTTP客户端
        mock_http = Mock()
        
        # 2. 模拟get方法返回404响应
        mock_response = Mock()
        mock_response.status_code = 404
        mock_http.get.return_value = mock_response
        
        # 3. 初始化API客户端，传入Mock的HTTP客户端（替代真实requests）
        client = ThirdPartyApiClient(http_client=mock_http)
        
        # 4. 执行测试：验证收到404时是否抛出预期异常
        with self.assertRaises(ValueError) as context:
            client.fetch_data("non-existent-resource-id")
        
        # 5. 检查异常信息是否符合预期
        self.assertEqual(str(context.exception), "Resource not found (404)")
        
        # 6. 额外验证：确保HTTP客户端的get方法被正确调用了（参数正确）
        mock_http.get.assert_called_once_with("https://third-party-api.com/resources/non-existent-resource-id")

if __name__ == "__main__":
    unittest.main()

核心思路拆解（所有OOP语言通用） #

不管用哪种语言，核心都是这几点：

1. 隔离依赖：把HTTP客户端抽象成可替换的依赖（比如通过接口、抽象类，或者像Python这样直接传对象），别让业务代码和真实HTTP客户端绑定死。
2. 模拟行为：用Mock工具创建假的HTTP客户端，让它返回我们需要的404响应——完全不需要访问真实服务器。
3. 验证逻辑：既测试结果（比如是否抛出异常、返回指定值），也验证依赖的调用行为（比如HTTP请求的URL是否正确），确保代码逻辑完全符合预期。

补个Java版的简化示例（用Mockito） #

如果是Java项目，思路一样，只是语法不同：

// 业务类（用Java 11+的HttpClient）
public class ThirdPartyApiClient {
    private final HttpClient httpClient;

    // 依赖注入：通过构造函数传入HttpClient
    public ThirdPartyApiClient(HttpClient httpClient) {
        this.httpClient = httpClient;
    }

    public String fetchData(String resourceId) throws IOException {
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://third-party-api.com/resources/" + resourceId))
                .GET()
                .build();

        HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());

        if (response.statusCode() == 404) {
            throw new IllegalArgumentException("Resource not found (404)");
        }
        return response.body();
    }
}

// 测试类（用JUnit 5 + Mockito）
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
import static org.mockito.Mockito.*;

public class ThirdPartyApiClientTest {
    @Test
    void testFetchDataHandles404() throws IOException {
        // 创建Mock的HttpClient和HttpResponse
        HttpClient mockHttpClient = mock(HttpClient.class);
        HttpResponse<String> mockResponse = mock(HttpResponse.class);

        // 模拟返回404状态码
        when(mockResponse.statusCode()).thenReturn(404);
        when(mockHttpClient.send(any(HttpRequest.class), any(HttpResponse.BodyHandler.class)))
                .thenReturn(mockResponse);

        // 初始化客户端，传入Mock对象
        ThirdPartyApiClient client = new ThirdPartyApiClient(mockHttpClient);

        // 验证是否抛出预期异常
        IllegalArgumentException exception = assertThrows(IllegalArgumentException.class,
                () -> client.fetchData("non-existent-id"));
        assertEquals("Resource not found (404)", exception.getMessage());

        // 验证HttpClient的send方法被正确调用
        verify(mockHttpClient, times(1)).send(any(HttpRequest.class), any(HttpResponse.BodyHandler.class));
    }
}

这样写出来的测试完全脱离真实服务器，速度快、可重复，而且不会受第三方API的可用性影响——完美符合单元测试的要求！

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