如何在Go与C函数间传递Go实例？含http.Client实操疑问

我需要在C代码中调用Go函数，把Go侧创建的http.Client实例以不透明指针的形式传递和操作，C侧只需要用HTTP_CLIENT_HDL类型来持有这个实例的句柄，具体调用流程如下：

C侧代码示例 #

typedef void* HTTP_CLIENT_HDL;

HTTP_CLIENT_HDL client_hdl = http_new_client();
int res = http_post(client_hdl, ...);
http_free_client(client_hdl);

Go侧原始代码（含疑问） #

/*
typedef void* HTTP_CLIENT_HDL; // 修正后的句柄类型
*/
import "C"
import (
    "net/http"
)

//export http_new_client
func http_new_client() (client_hdl C.HTTP_CLIENT_HDL){
    client := &http.Client{
        // 自定义配置
    }
    
    return C.HTTP_CLIENT_HDL(client)    // 是否正确？
                                        // 如何防止client的内存被Go GC回收？
}

//export http_post
func http_post(client_hdl C.HTTP_CLIENT_HDL, ...) (ret_val C.int) {
    client := &http.Client???(client_hdl)   // 如何将C.HTTP_CLIENT_HDL转回*http.Client？
    
    // 发送POST请求逻辑
    req, err := http.NewRequest("POST", ...)
    if err != nil {
        return 0
    }
    resp, err := client.Do(req)
    // ...后续处理
    
    return 1
}

//export http_free_client
func http_free_client(client_hdl C.HTTP_CLIENT_HDL){
    client := &http.Client???(client_hdl)   // 如何将C.HTTP_CLIENT_HDL转回*http.Client？
    
    free???(client)     // 如何释放client的内存？
}

问题解答 #

1. 如何将&http.Client转换为C类型？ #

首先不建议用size_t作为句柄类型，不同平台下指针宽度可能和size_t不匹配，更稳妥的是用void*作为HTTP_CLIENT_HDL的底层类型（如上面C代码所示）。

Go侧转换时，需要借助unsafe.Pointer做类型中转：

import "unsafe"

//export http_new_client
func http_new_client() C.HTTP_CLIENT_HDL {
    client := &http.Client{
        // 自定义配置
    }
    return C.HTTP_CLIENT_HDL(unsafe.Pointer(client))
}

2. 如何防止Go分配的内存被释放？ #

Go的垃圾回收器会回收所有没有被Go代码持有引用的对象，仅把指针传递给C的话，Go侧没有引用，GC可能会回收http.Client实例。最可靠的解决方式是维护一个全局的线程安全映射，保留对实例的引用：

import "sync"

var clientMap = make(map[C.HTTP_CLIENT_HDL]*http.Client)
var mu sync.Mutex

// 在http_new_client中添加：
hdl := C.HTTP_CLIENT_HDL(unsafe.Pointer(client))
mu.Lock()
clientMap[hdl] = client
mu.Unlock()
return hdl

3. 如何将C.HTTP_CLIENT_HDL类型转换为&http.Client类型？ #

同样通过unsafe.Pointer做反向转换：

import "unsafe"

//export http_post
func http_post(client_hdl C.HTTP_CLIENT_HDL, ...) C.int {
    // 直接转换
    client := (*http.Client)(unsafe.Pointer(client_hdl))
    
    // 或者从全局map中取出（更安全，可校验有效性）
    mu.Lock()
    client, ok := clientMap[client_hdl]
    mu.Unlock()
    if !ok {
        return 0 // 无效句柄
    }
    
    // 后续请求逻辑
    req, err := http.NewRequest("POST", ...)
    if err != nil {
        return 0
    }
    resp, err := client.Do(req)
    // ...
    
    return 1
}

4. 如何释放Go分配的内存？ #

Go的内存由GC自动管理，不需要手动调用free。我们只需要：

1. 从全局映射中删除对http.Client的引用，让GC可以回收该对象；
2. 如果http.Client内部有需要手动关闭的资源（比如自定义的Transport），先关闭这些资源再删除引用。

修改后的释放函数：

//export http_free_client
func http_free_client(client_hdl C.HTTP_CLIENT_HDL){
    mu.Lock()
    client, ok := clientMap[client_hdl]
    if ok {
        // 若有需要手动清理的资源，在此处理
        // 例如关闭空闲连接：client.Transport.(*http.Transport).CloseIdleConnections()
        delete(clientMap, client_hdl)
    }
    mu.Unlock()
    // GC会自动回收无引用的client实例
}

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