为什么在 Alpine 上编译的 Go 程序依赖 musl?即使 CGO_ENABLED=0

今天在玩 Gitea Action 时,发现部署到 1Panel 后出现了-bash: ./main: cannot execute: required file not found报错

一开始以为是上传失败了,ls了一下发现文件存在仔细看了一下,发现这不是文件不存在,而是依赖不存在

这时问题来了,Go明明是静态语言,为什么会有依赖呢

file main一下:

1
2
root@mei-home:/opt/apps/Thermohygrometer# file ./main
./main: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib/ld-musl-x86_64.so.1, BuildID[sha1]=aaf248e63656640884f4398b4b91f7816874f991, with debug_info, not stripped

发现依赖了musl运行库,那musl是什么呢,muslAlpine的 C 标准库(libc),相当于 Ubuntu 的 glibc。

这时想到了我构建应用时使用的 Alpine, Go 编译器底层调用的是 Alpine 的 linker(musl),所以生成的 ELF 头部写死了 interpreter 为 /lib/ld-musl-x86_64.so.1(即使CGO_ENABLE=0)

1
2
3
root@mei-home:/opt/apps/Thermohygrometer# ldd ./main
linux-vdso.so.1 (0x00007ffd949ea000)
libc.musl-x86_64.so.1 => not found

解决方案

解决方案很简单,在使用Go的交叉编译时会创建静态的二进制文件

1
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o main .

这样再检查一下

1
2
3
4
root@mei-home:/opt/apps/Thermohygrometer# ldd ./main
not a dynamic executable
root@mei-home:/opt/apps/Thermohygrometer# file main
main: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), statically linked, Go BuildID=EiBzV9q1enaIbGopv6tQ/TygrGeQ8AZBjwXzZ8GxH/dsSh1SEjtFORxlyVFYK2/Vw0VWXVbMZ5IBUderZZF, with debug_info, not stripped

果然没有问题了


为什么在 Alpine 上编译的 Go 程序依赖 musl?即使 CGO_ENABLED=0
https://mei.lv/articles/2025/musl-and-go.html
作者
mei
发布于
2025年10月7日
许可协议