OpenAPI生成客户端调用PATCH端点时报Invalid HTTP method错误求助

该异常是OpenAPI Generator生成的Spring客户端常见问题，本质是默认RestTemplate基于JDK自带HttpURLConnection实现，该实现原生不支持PATCH请求方法，因此调用PATCH接口时抛出Invalid HTTP method: PATCH错误。

方案一：替换RestTemplate的请求工厂（推荐） #

切换为支持PATCH方法的Apache HttpComponents客户端实现，步骤如下：

• 第一步：引入Apache HttpComponents依赖（Maven示例）

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.14</version> <!-- 可替换为对应稳定版本 -->
</dependency>

• 第二步：修改ApiClient初始化代码，配置支持PATCH的请求工厂
  修改你的getMyApiClient方法，新增请求工厂配置即可：

private ApiClient getMyApiClient() {
    ApiClient apiClient = new ApiClient();
    apiClient.setDebugging(true);
    if (Boolean.TRUE.equals(addToken)) {
        final String token = tokenProvider.getTokenFromAzure();
        apiClient.setBearerToken(token);
    }
    apiClient.setBasePath(MyBaseUrl);
    // 新增配置：使用Apache HttpComponents作为请求工厂，支持PATCH方法
    HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory();
    apiClient.getRestTemplate().setRequestFactory(requestFactory);
    return apiClient;
}

方案二：生成客户端时指定WebClient作为底层实现 #

如果你的项目使用Spring WebFlux技术栈，可在生成OpenAPI客户端时添加配置参数library=webclient，生成基于WebClient的客户端，天然支持所有HTTP标准方法，无需额外适配。

方案三：使用HTTP方法覆写（兼容场景使用） #

如果无法替换请求工厂，可在服务端开启X-HTTP-Method-Override请求头支持，客户端发送POST请求并携带X-HTTP-Method-Override: PATCH头，即可实现PATCH请求的兼容调用。

内容的提问来源于stack exchange，提问作者f.trajkovski