如何在OpenAPI生成的Go客户端中使用自定义HTTP客户端（无需改生成代码）

方法一：自定义OpenAPI Generator模板（推荐，无需后续手动修改） #

这是最彻底的方案，通过修改生成模板，让生成的Configuration结构体使用接口类型而非具体的*http.Client：

1. 获取并修改Go模板文件

   • 找到OpenAPI Generator的Go模板中定义Configuration的文件：本地安装的generator可通过openapi-generator config-help -g go查看模板路径，也可直接复制官方Go模板的configuration.mustache文件到本地目录（比如./custom-templates/go）。
   • 打开复制的文件，在结构体定义上方添加接口声明：

     // HTTPClient defines the interface for HTTP clients compatible with the API client
     type HTTPClient interface {
         Do(*http.Request) (*http.Response, error)
     }
     

   • 将结构体中的HTTPClient *http.Client改为：

     HTTPClient HTTPClient
     

2. 使用自定义模板生成代码
   修改生成命令，加上--template-dir参数指定自定义模板路径：

   openapi-generator generate -g go -i spec.yaml -o code-gen-go -p packageName=mypackage --template-dir ./custom-templates/go
   

3. 直接使用自定义客户端
   生成的代码中Configuration.HTTPClient现在是接口类型，你的*customHttp.Client因为实现了Do方法，可直接赋值：

   cfg := mypackage.NewConfiguration()
   cfg.HTTPClient = customHttp.NewClient(/* 你的配置 */)
   

方法二：适配器模式（无需修改模板，但需编写适配代码） #

如果不想自定义模板，可通过适配器将*customHttp.Client包装成*http.Client兼容的类型（注意：此方法需确保自定义客户端的核心逻辑通过嵌入的*http.Client实现）：

1. 编写适配器结构体

   type CustomClientAdapter struct {
       inner *customHttp.Client
   }
   
   // 实现http.Client的Do方法，转发到自定义客户端
   func (a *CustomClientAdapter) Do(req *http.Request) (*http.Response, error) {
       return a.inner.Do(req)
   }
   

2. 替换生成代码中的HTTPClient
   由于生成的代码期望*http.Client，我们利用Go的结构体嵌入特性，将适配器包装成*http.Client的兼容实例：

   customClient := customHttp.NewClient(/* 你的配置 */)
   adapter := &CustomClientAdapter{inner: customClient}
   
   // 创建临时http.Client，替换其Transport执行请求
   cfg := mypackage.NewConfiguration()
   cfg.HTTPClient = &http.Client{
       Transport: adapter,
   }
   

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