从Go调用Python回调指针触发SIGSEGV段错误的问题排查

你遇到的这个SIGSEGV段错误，主要是因为Go/Python回调交互中的类型不匹配、生命周期管理不当，以及CGO的一些规则没遵守导致的，咱们一步步拆解问题并给出修复方案：

核心问题分析 #

1. Go导出函数的回调类型错误 #

你在Go里定义了type convert func()作为callme的参数，但CGO导出函数的参数必须是C兼容的类型——Go的原生函数类型无法被C（或Python的ctypes）正确识别，这会导致传递的指针是无效的，调用时直接访问错误内存地址，触发段错误。

2. 回调函数签名不匹配 #

Python里你定义的CFUNCTYPE(c_int)表示回调函数返回一个整数，但Go那边期望的是无参数、无返回值的函数，这种签名不匹配会破坏调用栈结构，直接引发内存错误。

3. Python回调对象的生命周期问题 #

Python的cmp_func = CMPFUNC(print_tick)如果没有被持续持有引用，可能在Go后台线程还在运行时就被Python的垃圾回收器回收，导致回调指针变成野指针，调用时触发段错误。

修复后的代码示例 #

修正后的Go代码 #

package main

import "time"
import "fmt"
import "C"

//export callme
// 使用C兼容的函数指针类型作为参数
func callme(fn C.callback_fn) {
    // 封装C函数指针为可调用的Go函数
    invokeCallback := func() {
        // 通过辅助C函数安全调用回调指针
        C.call_fn(fn)
    }

    doneChan := make(chan bool)
    go func() {
        time.Sleep(time.Second * 5)
        doneChan <- true
    }()

    ticker := time.NewTicker(time.Millisecond * 500)
    defer ticker.Stop() // 确保ticker退出时被关闭，避免资源泄漏

    for {
        select {
        case <-ticker.C:
            fmt.Println("Ticker ticked")
            invokeCallback()
        case <-doneChan:
            fmt.Println("Done")
            return
        }
    }
}

// 嵌入C代码定义回调类型和辅助调用函数
/*
#include <stdint.h>
// 定义C侧的回调函数类型：无参数、无返回值
typedef void (*callback_fn)(void);

// 辅助函数：安全调用回调指针（避免Go直接操作C函数指针的风险）
static inline void call_fn(callback_fn fn) {
    if (fn != NULL) {
        fn();
    }
}
*/
import "C"

func main() {
    // 因为我们编译为共享库给Python调用，main函数可以留空
}

修正后的Python代码 #

from ctypes import *

def print_tick():
    print("hey")

# 定义与Go侧匹配的回调类型：无参数、无返回值
CMPFUNC = CFUNCTYPE(None)
# 创建回调对象，必须保持引用避免被GC回收
cmp_func = CMPFUNC(print_tick)

# 加载编译好的Go共享库
lib = cdll.LoadLibrary("./test2.so")
# 显式指定函数参数类型，确保调用栈正确
lib.callme.argtypes = [CMPFUNC]

# 调用Go的导出函数
lib.callme(cmp_func)

# 保持程序运行，防止cmp_func被回收（实际场景中可以用其他方式维持生命周期）
input("Press Enter to exit...\n")

编译与运行注意事项 #

1. 编译Go共享库时，需要使用CGO_ENABLED=1，并指定目标平台：

CGO_ENABLED=1 GOOS=darwin GOARCH=amd64 go build -buildmode=c-shared -o test2.so test2.go

（注意：根据你的操作系统调整GOOS，比如Linux用linux，Windows用windows）

2. 运行Python脚本时，确保test2.so在当前目录下。

关键修复点总结 #

• 永远用C兼容的类型作为CGO导出函数的参数，不要用Go原生的函数类型。
• 严格匹配Go和Python之间的回调签名（参数数量、类型、返回值），一点都不能错。
• 必须保持Python回调对象的引用，直到Go的回调逻辑完全结束，避免GC回收导致野指针。
• 通过辅助C函数调用回调指针，避免Go直接操作C函数指针带来的风险。

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