Go C-shared共享库启动HTTP服务后主进程直接退出问题

核心错误原因 #

• 共享库导出函数参数不符合C ABI规范
  Go导出供C调用的函数，不能直接使用Go原生string类型。Go的string是带长度信息的结构体，无法被C端识别，会导致参数传递完全错误，甚至触发未定义行为。
• 主程序完全没有正确调用共享库的导出逻辑
  • 主程序C块中手动定义了空实现的void Run(char* port){}，实际调用的是这个本地空函数，完全没有触发共享库的任何逻辑
  • 调用dlopen获取到共享库句柄后，没有执行dlsym获取导出的Run函数指针，等于白打开了共享库
  • 函数名大小写不匹配：Go导出的C函数名是大写开头的Run，C语言大小写敏感，写C.run根本无法匹配到对应符号
• 进程退出的本质原因
  原本进程直接终止是因为根本没执行到HTTP服务逻辑。只要正确调用ListenAndServe（该接口本身是阻塞调用），进程就会停在服务监听逻辑上，不会直接退出。

分步解决方法 #

1. 修正共享库server.go的导出规范 #

调整C导入的位置，将导出函数的参数改为C兼容的*C.char类型，正确转换参数后再启动HTTP服务，修正后代码：

// server.go
package main

import "C"
import (
	"fmt"
	"net/http"
)

func hello(w http.ResponseWriter, req *http.Request) {
	fmt.Fprintf(w, "hello\n")
}
func headers(w http.ResponseWriter, req *http.Request) {
	for name, headers := range req.Header {
		for _, h := range headers {
			fmt.Fprintf(w, "%v: %v\n", name, h)
		}
	}
}
func main() {}

//export Run
func Run(port *C.char) {
	goPort := C.GoString(port)
	http.HandleFunc("/hello", hello)
	http.HandleFunc("/headers", headers)
	fmt.Printf("服务已启动，监听 localhost:%s\n", goPort)
	if err := http.ListenAndServe("localhost:"+goPort, nil); err != nil {
		fmt.Println("ListenAndServe 错误: ", err)
	}
}

重新编译共享库，命令不变：

go build -buildmode c-shared -o server.so server.go

2. 重写主程序的动态调用逻辑 #

不要手动写空的Run实现，需要通过dlsym从共享库句柄中获取真实的导出函数指针，定义和导出函数匹配的函数类型后再调用，修正后main.go代码：

package main

/*
#cgo LDFLAGS: -ldl
#include <dlfcn.h>
#include <stdlib.h>

// 定义和共享库导出函数签名完全匹配的函数类型
typedef void (*RunFunc)(char* port);
*/
import "C"
import (
	"fmt"
	"unsafe"
)

func main() {
	// 打开共享库
	soPath := C.CString("./server.so")
	defer C.free(unsafe.Pointer(soPath))
	handle := C.dlopen(soPath, C.RTLD_LAZY)
	if handle == nil {
		errStr := C.GoString(C.dlerror())
		fmt.Printf("打开共享库失败: %s\n", errStr)
		return
	}
	defer C.dlclose(handle)

	// 清空之前的错误缓存
	C.dlerror()

	// 获取共享库导出的Run函数符号
	runSymbol := C.CString("Run")
	defer C.free(unsafe.Pointer(runSymbol))
	runPtr := C.dlsym(handle, runSymbol)
	if runPtr == nil {
		errStr := C.GoString(C.dlerror())
		fmt.Printf("获取Run函数失败: %s\n", errStr)
		return
	}

	// 转换为可调用的函数类型并执行
	runFunc := (*C.RunFunc)(unsafe.Pointer(runPtr))
	port := C.CString("8090")
	defer C.free(unsafe.Pointer(port))
	(*runFunc)(port)
}

3. 执行验证 #

运行主程序命令：

go run main.go

正常输出启动提示后，访问http://localhost:8090/hello即可获取返回内容。

内容的提问来源于stack exchange，提问作者Hasan A Yousef