如何通过Docker交叉编译适用于Linux的Go C共享库供Java调用？

问题背景 #

需要在Mac环境下编译Go生成C共享库（.so文件），供目标Linux主机的Java代码调用，目标主机规格：

# uname -a
Linux <hostname> 5.14.0-284.25.1.el9_2.x86_64 #1 SMP PREEMPT_DYNAMIC Thu Jul 20 09:11:28 EDT 2023 x86_64 x86_64 x86_64 GNU/Linux

本地Mac测试时，用go build -o libmybinary.so -buildmode=c-shared main.go可正常生成可用库，但适配Linux主机时遇到以下问题：

• 不指定GOOS/GOARCH编译，生成的二进制无法在Linux运行
• 添加CGO_ENABLED=1 GOOS=linux GOARCH=amd64编译时，Docker报错gcc: error: unrecognized command line option '-m64'
• 指定--platform=linux/amd64编译出的.so格式适配Linux，但Java找不到导出方法，推测是CGO工具链行为异常导致符号未正确导出

解决方案 #

1. 使用匹配目标系统的原生Linux镜像编译 #

核心是用64位Linux原生镜像作为编译环境，确保C工具链（gcc、glibc等）与目标RHEL9系统兼容，避免交叉编译的工具链问题。

示例Dockerfile

# 选择golang官方linux/amd64镜像，版本与本地开发环境保持一致
FROM --platform=linux/amd64 golang:1.22-alpine as builder

# 安装C编译依赖（alpine环境需安装gcc和musl-dev；若用RHEL9镜像则安装gcc glibc-devel）
RUN apk add --no-cache gcc musl-dev

# 设置工作目录
WORKDIR /app

# 复制Go依赖文件并下载依赖
COPY go.mod go.sum ./
RUN go mod download

# 复制源码文件
COPY main.go ./

# 编译C共享库：无需手动指定GOOS/GOARCH，镜像本身就是linux/amd64环境
RUN CGO_ENABLED=1 go build -o libmybinary.so -buildmode=c-shared main.go

# 可选：用轻量镜像打包最终产物（若需部署）
FROM --platform=linux/amd64 alpine:3.20
COPY --from=builder /app/libmybinary.so /usr/lib/

2. 确保Go代码正确导出JNI可识别的符号 #

Java通过JNI调用时，Go代码必须严格遵循C符号导出规范，否则无法被识别：

• 导出函数必须添加//export 函数名注释
• 函数参数/返回值必须使用C兼容类型（依赖C包的类型，如C.int、C.char*）
• import "C"必须紧跟在包含C头文件的注释块后，中间不能有空行

示例main.go结构

package main

/*
#include <stdlib.h>
*/
import "C"
import "unsafe"

//export MyProcessFunction
func MyProcessFunction(input *C.char) *C.char {
    goInput := C.GoString(input)
    result := "JNI Processed: " + goInput
    return C.CString(result)
}

//export FreeCString
func FreeCString(str *C.char) {
    C.free(unsafe.Pointer(str))
}

// 空main函数：编译为C共享库时必须存在
func main() {}

3. 验证编译结果 #

编译完成后，可通过以下命令确认产物有效性：

• 检查文件格式：

file libmybinary.so

输出需包含ELF 64-bit LSB shared object, x86-64，确认适配目标系统。

• 检查符号导出：

nm -D libmybinary.so | grep MyProcessFunction

输出需显示类似0000000000012345 T MyProcessFunction，说明符号已正确导出。

4. 问题根源说明 #

• gcc: error: unrecognized command line option '-m64'：原source镜像为32位系统或gcc版本过低，不支持64位编译选项，切换到64位Linux镜像即可解决。
• Java找不到导出方法：要么是Go代码的导出注释不规范，要么是编译时CGO_ENABLED未设为1导致符号被优化，需确保两者都符合要求。

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