Golang 1.18.4生成静态二进制文件而1.19.1却生成动态二进制文件的问题

Golang 1.18.4生成静态二进制文件而1.19.1却生成动态二进制文件的问题 在我的 Ubuntu 22.04 平台上，一个原本是静态的二进制文件（使用 Go v1.18.4 编译）现在显示为动态的（使用 file 命令检查），这是在使用 Go v1.19.1 时发生的情况。我使用以下命令创建了该二进制文件：

$go build -ldflags -extldflags=-static

Go v1.19.1 是否有什么变化？ldd 命令显示其依赖于：

 linux-vdso.so.1
 libpthread.so.0
 libc.so.6
 /lib64/ld-linux-x86-64.so.2

二进制文件大小的差异小于 3%，所以大小上没有巨大差别。如果可能的话，我更倾向于编译一个静态二进制文件。

我在网上搜索了一下，有人建议我应该使用以下命令构建：

$go build -ldflags "-linkmode external -extldflags=-static"

使用 linkmode 选项后，我得到了一堆警告，内容是关于在静态链接的应用程序中使用 ‘getgrouplist’/‘mygetgrgid_r’/‘mygetgrnam_r’/‘mygetpwuid_r’/‘cgo_*_getaddrinfo’ 需要在运行时使用链接时所用 glibc 版本的共享库。但生成的二进制文件是静态的！

当程序尝试使用这些库时，它会崩溃吗？还是说它会简单地引入必要的动态库？

我的理想是发布一个静态二进制文件。但考虑到迁移到 Go v1.19.1，我是应该直接发布动态版本，并希望没有兼容性问题，还是应该使用 -linkmode external 构建，并希望一切都能正常工作？


更多关于Golang 1.18.4生成静态二进制文件而1.19.1却生成动态二进制文件的问题的实战教程也可以访问 https://www.itying.com/category-94-b0.html

1 回复

更多关于Golang 1.18.4生成静态二进制文件而1.19.1却生成动态二进制文件的问题的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html


在 Go 1.19.1 中，静态链接的行为确实发生了变化。从 Go 1.19 开始，当使用 -extldflags=-static 时，Go 工具链现在会默认使用 -linkmode=internal，这可能导致某些系统库仍然保持动态链接。

以下是解决方案和示例：

1. 使用正确的构建命令

对于 Go 1.19+，要生成完全静态的二进制文件，需要使用：

CGO_ENABLED=0 go build -ldflags="-s -w" -a -o your_binary

或者使用外部链接模式：

go build -ldflags="-linkmode=external -extldflags=-static" -o your_binary

2. 完整静态构建示例

// main.go
package main

import "fmt"

func main() {
    fmt.Println("Fully static binary")
}

构建命令：

# 方法1：禁用CGO（推荐）
CGO_ENABLED=0 go build -a -ldflags="-s -w" -o static_binary

# 方法2：使用外部链接
go build -ldflags="-linkmode=external -extldflags='-static -lpthread'" -o static_binary

3. 验证静态二进制文件

# 检查文件类型
file static_binary

# 检查依赖
ldd static_binary 2>/dev/null || echo "Not a dynamic executable"

# 检查glibc依赖
strings static_binary | grep ^GLIBC_ || echo "No GLIBC dependencies found"

4. 处理警告问题

关于你提到的警告，这些函数确实在静态链接时可能有问题。解决方案：

// 在代码中添加构建约束
// +build !static

// 或者使用条件编译
package main

/*
#cgo static LDFLAGS: -static
*/
import "C"

import (
    "fmt"
    "os"
)

func main() {
    fmt.Println("Static build")
    os.Exit(0)
}

构建脚本：

#!/bin/bash
# build_static.sh

export CGO_ENABLED=1
export GOOS=linux
export GOARCH=amd64

# 使用musl-libc替代glibc来避免兼容性问题
# 需要先安装musl-gcc
if command -v musl-gcc &> /dev/null; then
    CC=musl-gcc go build -ldflags="-linkmode=external -extldflags=-static" -o binary_static
else
    CGO_ENABLED=0 go build -a -ldflags="-s -w" -o binary_static
fi

5. 使用Docker进行静态构建

# Dockerfile
FROM golang:1.19-alpine AS builder

WORKDIR /app
COPY . .

# Alpine使用musl libc，可以生成真正的静态二进制
RUN CGO_ENABLED=0 go build -a -ldflags="-s -w" -o app

FROM scratch
COPY --from=builder /app/app /app
ENTRYPOINT ["/app"]

构建命令：

docker build -t static-app .
docker run --rm static-app

6. 检查Go版本差异

// build_info.go
package main

import (
    "fmt"
    "runtime"
)

func main() {
    fmt.Printf("Go version: %s\n", runtime.Version())
    fmt.Printf("GOOS: %s, GOARCH: %s\n", runtime.GOOS, runtime.GOARCH)
}

使用不同版本构建比较：

# Go 1.18.4
go1.18.4 build -ldflags="-extldflags=-static" -o binary_1.18

# Go 1.19.1
go1.19.1 build -ldflags="-linkmode=external -extldflags=-static" -o binary_1.19

关于你的具体问题：

  • 使用 -linkmode external 构建的二进制文件在运行时不会崩溃，但那些警告提到的函数可能无法正常工作
  • 如果程序使用了 net 包进行DNS解析，在静态链接时可能会有问题
  • 建议使用 CGO_ENABLED=0 进行构建，这是最可靠的静态构建方法

选择哪种方案取决于你的具体需求。如果程序简单且不需要cgo功能，使用 CGO_ENABLED=0 是最佳选择。如果需要cgo功能，则需要处理glibc的静态链接限制。

回到顶部