如何在Python中释放cgo生成的C struct及对应字段的内存？

现有代码崩溃根因 #

• 直接拼写错误：Python代码最后一行Free(r.reponse)字段名拼写错误，应为Free(r.response)，传入野指针触发内存访问错误直接导致崩溃
• 不规范操作：每次调用释放函数时动态设置argtypes，属于多余操作，也可能因为重复设置触发未知异常

最优释放方案 #

cgo分配的C堆内存（包括C.CString、C.CBytes生成的内容）不受Go GC和Python GC管理，必须由Go侧调用C.free释放，禁止在Python侧直接用ctypes的free释放，避免不同编译单元的内存分配器不兼容问题。

方案1：仅释放结构体内部字段（适配当前返回值为结构体值的场景） #

当前Go侧返回的是C.Resp值类型，结构体本身的内存由ctypes管理，只需要释放内部的response字符串指针即可，修正后代码如下：

Go侧代码（无改动，可直接用）

//export getResponse
func getResponse() C.Resp {
    return C.Resp{
        response: C.CString(Response.respBody),
    }
}

//export freeResponse
func freeResponse(response *C.char) {
    if response == nil {
        return
    }
    C.free(unsafe.Pointer(response))
}

Python侧优化代码

from ctypes import cdll, Structure, c_char_p

# 全局只加载一次共享库，提前设置所有函数签名
lib = cdll.LoadLibrary("./你的共享库路径.so") # Windows替换为.dll，Mac替换为.dylib
lib.getResponse.restype = Resp
lib.freeResponse.argtypes = [c_char_p]

# 结构体封装自动释放能力，避免手动遗漏释放
class Resp(Structure):
    _fields_ = [
        ('response', c_char_p)
    ]

    # 实现上下文管理器，不管是否抛出异常都会自动释放内存
    def __enter__(self):
        return self
    
    def __exit__(self, exc_type, exc_val, exc_tb):
        if self.response:
            lib.freeResponse(self.response)
            self.response = None # 标记为空避免重复释放

# 调用示例
with lib.getResponse() as r:
    # 拿到C指针后立刻转成Python原生字符串，不要长期持有C指针
    resp_str = r.response.decode("utf-8")
    print(resp_str)

方案2：返回结构体指针场景的完整释放 #

如果后续调整Go代码返回堆上分配的*C.Resp指针，需要同时释放结构体本身和内部字段，扩展实现如下：

Go侧新增释放方法

//export freeRespStruct
func freeRespStruct(resp *C.Resp) {
    if resp == nil {
        return
    }
    // 先释放内部字段
    C.free(unsafe.Pointer(resp.response))
    // 再释放结构体本身
    C.free(unsafe.Pointer(resp))
}

Python侧调用

lib.freeRespStruct.argtypes = [POINTER(Resp)]
lib.getResponse.restype = POINTER(Resp)

# 使用后直接传入结构体指针即可完成全部释放
r_ptr = lib.getResponse()
lib.freeRespStruct(r_ptr)

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