go编译为c共享库（-buildmode=c-shared）后，导出函数若直接接收go原生string类型，而调用方（如java/jna或python/ctypes）传入c风格null终止字符串，将引发严重内存错误；正确做法是接收* c.char并用c.gostring安全转换。
go编译为c共享库（-buildmode=c-shared）后，导出函数若直接接收go原生string类型，而调用方（如java/jna或python/ctypes）传入c风格null终止字符串，将引发严重内存错误；正确做法是接收* c.char并用c.gostring安全转换。
在使用 go build -buildmode=c-shared 构建供外部语言调用的共享库时，一个常见却极易被忽视的关键约束是：所有导出函数（//export）的参数和返回值必须严格遵循C ABI规范。Go原生的string类型在内存中由两部分组成——一个指向底层字节数组的指针 + 一个长度字段（共16字节），而C语言中的字符串仅是一个以\0结尾的char*指针（通常8字节）。当Java或Python通过JNA/ctypes传递一个C字符串（例如"World"）时，实际传入的是该字符串首地址（如0x7f5e48155490），但Go运行时误将其解释为一个string结构体——把该地址当作指针字段，把紧邻的8字节（如0x7f5e4d27dc86）当作长度字段。由于后者是一个极大无意义数值（如示例中解析出约140TB），Go的runtime.concatstring3在尝试分配该长度内存时立即触发out of memory panic。
✅ 正确实现方式是：*显式声明参数为`C.char，再通过C.GoString()转换为Go字符串**。C.GoString()会安全读取C字符串直到遇到\0`，并分配正确的Go字符串对象。
以下是修正后的完整Go代码：
// libsample.go
package main
import "C"
import "fmt"
//export Hello
func Hello(s *C.char) {
// 安全地将C字符串转换为Go字符串
goStr := C.GoString(s)
fmt.Println("Hello " + goStr + "!")
}
//export Add
func Add(a, b C.int) C.int {
return a + b
}
func main() {
// c-shared模式下main函数必须存在，但可为空
}
编译命令保持不变：
go build -o libsample.so -buildmode=c-shared .
对应调用端无需修改（JNA/ctypes仍按C规则传参）：
-
Python示例（正常工作）：
# test.py import ctypes lib = ctypes.CDLL("./libsample.so") lib.Hello(b"World") # 注意：必须传bytes，而非str -
Java/JNA示例（正常工作）：
public interface GoSO extends Library { GoSO INSTANCE = Native.loadLibrary("sample", GoSO.class); void Hello(String s); // JNA自动处理String → char* }
⚠️ 注意事项：
- C.GoString(s)要求s非空且为合法C字符串（以\0结尾），否则可能panic；如需处理可能为NULL的指针，应先判空：if s != nil { C.GoString(s) }；
- 若需返回字符串给C调用方，必须使用C.CString()并手动管理内存（调用方需C.free()），避免内存泄漏；
- 所有导出函数参数/返回值必须是C兼容类型（如C.int, C.double, *C.char, unsafe.Pointer等），禁止使用Go切片、map、channel、interface等；
- main()函数在c-shared模式下不可省略，但内容可为空。
通过严格遵守C ABI契约，即可安全、高效地实现Go与外部语言的互操作。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
