使用Bazel+CGO构建Go项目时dlsym未定义问题求助

问题背景 #

项目环境：

• 构建系统：搭配CGO的Bazel
• C代码调用了dlsym()，已引入#include <dlfcn.h>
• Go代码import "C"上方添加了// #cgo LDFLAGS: -ldl
• 构建时发现链接命令中未包含-ldl，报错：

external/go_sdk/pkg/tool/linux_amd64/link: running external/llvm_toolchain/bin/cc_wrapper.sh failed: exit status 1
ld.lld: error: undefined symbol: dlsym

解决方案 #

1. 在BUILD文件的Go规则中显式添加链接选项 #

Bazel的rules_go不会自动读取Go文件中的#cgo LDFLAGS配置（尤其是使用自定义工具链时），需要在对应的go_binary或go_library规则中添加linkopts：

go_binary(
    name = "your_binary",
    srcs = ["main.go"],
    # 显式添加-ldl链接库
    linkopts = ["-ldl"],
    cgo = True,
)

如果需要跨平台兼容，可通过select仅在Linux平台添加：

go_binary(
    name = "your_binary",
    srcs = ["main.go"],
    linkopts = select({
        "@io_bazel_rules_go//go/platform:linux": ["-ldl"],
        "//conditions:default": [],
    }),
    cgo = True,
)

2. 确保未禁用CGO或启用纯Go构建 #

检查BUILD规则中是否设置了pure = "on"或static = "on"，这会导致CGO链接参数被忽略：

• 移除pure = "on"（如果存在）
• 若使用静态链接，需将-ldl替换为静态版本的链接参数（通常为-l:libdl.a，但需确认系统中存在对应静态库）

3. 自定义CGO工具链（进阶） #

如果项目使用了自定义cgo_toolchain，可在工具链配置中添加ldflags：

cgo_toolchain(
    name = "custom_cgo_toolchain",
    ldflags = ["-ldl"],
    # 其他工具链配置...
)

然后在go_binary中指定toolchain = ":custom_cgo_toolchain"

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