如何构建支持Python调用CGO代码的Docker容器？

这个方案完全可行，你预设的流程逻辑没有问题，绝大多数构建失败的原因是没有适配Docker容器默认的Linux运行环境：你本地Windows环境编译输出的是.dll后缀动态库，Linux容器中编译输出的是.so后缀的动态库，调整对应编译参数和Python调用逻辑即可正常运行。

采用多阶段构建可以把Go编译环境和Python运行环境分离，最终镜像只保留运行必须的文件，占用空间更小：

# 第一阶段：Go编译阶段，直接使用官方Go镜像，自带完整Go环境
FROM golang:1.21-alpine AS go-builder

# 安装CGO编译需要的C编译器和基础依赖
RUN apk add --no-cache gcc musl-dev

# 设置Go代码工作目录
WORKDIR /go/src/cgo-lib

# 提前复制go.mod、go.sum缓存依赖，避免每次修改源码都重新下载依赖
COPY go.mod go.sum ./
RUN go mod download

# 复制所有Go/CGO源码
COPY ./go-src .

# 编译为Linux平台的动态共享库，输出到指定路径方便后续复制
RUN CGO_ENABLED=1 GOOS=linux go build -buildmode=c-shared -o /usr/lib/libgohelper.so .

# 第二阶段：Python运行阶段，仅保留运行需要的依赖
FROM python:3.11-slim

# 设置Python项目工作目录
WORKDIR /app

# 从编译阶段复制已经编译好的动态库到系统库路径
COPY --from=go-builder /usr/lib/libgohelper.so /usr/lib/
# 更新动态库缓存，避免Python加载时找不到库
RUN ldconfig

# 安装Python依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制Python源码
COPY ./py-src .

# 指定容器启动入口
CMD ["python", "main.py"]

• Go代码中需要对外暴露的函数必须加上//export 函数名的注释，否则编译出来的动态库不会导出对应符号，Python调用会报错
• Python调用侧需要做跨系统兼容，适配Windows和Linux不同的动态库后缀：

import ctypes
import os
if os.name == 'nt':
    # Windows环境加载本地dll
    lib = ctypes.cdll.LoadLibrary('./dllname.dll')
else:
    # Linux容器环境加载so
    lib = ctypes.cdll.LoadLibrary('libgohelper.so')

• 如果你的Go代码依赖第三方C库，需要在编译阶段提前安装对应的C依赖包，否则会出现头文件找不到的编译错误
• 不要直接把Windows下编译的dll复制到Linux容器中使用，跨平台的二进制文件无法兼容运行

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