Spring Boot中MockServer与实际运行环境下带请求体的GET请求行为不一致的测试问题

兄弟我太懂你这个痛点了！之前我也踩过类似的坑——测试环境跑的好好的，一到生产就炸，排查半天发现是Mock工具和真实客户端的行为差异，确实挺闹心的。

先给你捋清楚问题根源：
你用的MockRestServiceServer默认依赖的是SimpleClientHttpRequestFactory，这个实现对HTTP规范的校验相当宽松，它不会拦截GET请求带请求体的情况；但你生产环境用的OkHttp是严格遵循RFC规范的，GET请求带请求体本身就不符合HTTP设计初衷，所以直接抛出了IllegalArgumentException，这就是测试和真实环境的核心差异。

下面给你几个可行的解决方案，帮你把这个场景覆盖到测试里：

1. 测试时和生产环境用同一款HTTP客户端 #

最简单直接的办法，就是在测试中让RestTemplate使用和生产环境完全一致的OkHttp客户端，这样MockRestServiceServer也会通过OkHttp的逻辑处理请求，自然就能触发和生产一样的异常了。

代码示例：

@BeforeEach
void setUp() {
    // 初始化和生产环境一致的OkHttp请求工厂
    OkHttp3ClientHttpRequestFactory okHttpFactory = new OkHttp3ClientHttpRequestFactory();
    // 用这个工厂创建RestTemplate
    RestTemplate restTemplate = new RestTemplate(okHttpFactory);
    // 基于这个RestTemplate创建MockServer
    mockServer = MockRestServiceServer.createServer(restTemplate);
}

这样测试时，只要你的代码尝试给GET请求加请求体，就会立刻抛出那个异常，再也不会出现“测试过了生产炸”的情况。

2. 从代码逻辑根源避免GET带请求体 #

把请求构建的逻辑抽成独立工具方法，根据请求方法自动决定是否携带请求体，从根源上杜绝这个问题，同时给这个方法写单元测试：

public <T> HttpEntity<T> buildHttpEntity(HttpMethod method, T body, HttpHeaders headers) {
    // GET请求强制只传headers，body置为null
    if (HttpMethod.GET.equals(method)) {
        return new HttpEntity<>(headers);
    }
    return new HttpEntity<>(body, headers);
}

然后针对这个方法写单元测试：

@Test
void whenBuildGetHttpEntity_thenBodyIsNull() {
    HttpHeaders headers = new HttpHeaders();
    headers.add("Authorization", "Bearer token");
    String testBody = "test-body";

    HttpEntity<String> entity = buildHttpEntity(HttpMethod.GET, testBody, headers);

    assertNull(entity.getBody());
    assertEquals(headers, entity.getHeaders());
}

这种方式不仅能覆盖测试场景，还能从代码层面避免错误，比单纯靠测试拦截更稳妥。

3. 自定义严格的请求工厂模拟真实环境校验 #

如果不想在测试中引入OkHttp依赖，也可以自定义一个严格遵循HTTP规范的ClientHttpRequestFactory，在测试时替换默认实现，专门拦截GET带请求体的情况：

public class StrictHttpRequestFactory extends SimpleClientHttpRequestFactory {
    @Override
    protected ClientHttpRequest createRequest(URI uri, HttpMethod httpMethod) throws IOException {
        if (HttpMethod.GET.equals(httpMethod)) {
            return new StrictGetClientHttpRequest(super.createRequest(uri, httpMethod));
        }
        return super.createRequest(uri, httpMethod);
    }

    private static class StrictGetClientHttpRequest implements ClientHttpRequest {
        private final ClientHttpRequest delegate;

        public StrictGetClientHttpRequest(ClientHttpRequest delegate) {
            this.delegate = delegate;
        }

        @Override
        public OutputStream getBody() throws IOException {
            // GET请求尝试获取请求体时直接抛出异常
            throw new IllegalArgumentException("method GET must not have a request body.");
        }

        // 其他方法直接委托给原生实现
        @Override
        public URI getURI() { return delegate.getURI(); }
        @Override
        public HttpMethod getMethod() { return delegate.getMethod(); }
        @Override
        public HttpHeaders getHeaders() { return delegate.getHeaders(); }
        @Override
        public ClientHttpResponse execute() throws IOException { return delegate.execute(); }
    }
}

测试时用这个工厂创建RestTemplate：

@BeforeEach
void setUp() {
    RestTemplate restTemplate = new RestTemplate(new StrictHttpRequestFactory());
    mockServer = MockRestServiceServer.createServer(restTemplate);
}

个人最推荐前两种方案——要么和生产环境对齐客户端，要么从逻辑上避免错误，既能保证测试覆盖，也能减少后续的潜在问题。

备注：内容来源于stack exchange，提问作者M_F