mengyamonitor/mengyamonitor-backend/BUILD.md

编译说明 - 兼容旧版本系统

问题说明

如果在 Debian 11 或其他旧版本系统上运行时出现 GLIBC 版本错误：

./mengyamonitor-backend: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found

这是因为编译时使用了较新版本的 GLIBC，而目标系统的 GLIBC 版本较旧。

解决方案

方案 1：在目标系统上编译（推荐）

在 Debian 11 服务器上直接编译：

cd mengyamonitor-backend

# 禁用 CGO，静态链接
export CGO_ENABLED=0
go build -ldflags="-s -w" -o mengyamonitor-backend .

# 或者使用提供的脚本
chmod +x build.sh
./build.sh

方案 2：使用静态链接编译

在任何系统上编译，但使用静态链接：

cd mengyamonitor-backend

# 禁用 CGO
export CGO_ENABLED=0
export GOOS=linux
export GOARCH=amd64

# 编译（静态链接，不依赖系统库）
go build -ldflags="-s -w" -o mengyamonitor-backend .

方案 3：使用 Docker 编译

使用 Docker 在 Debian 11 环境中编译：

# 使用 Debian 11 镜像编译
docker run --rm -v $(pwd):/app -w /app golang:1.21-bullseye sh -c "
    export CGO_ENABLED=0
    go build -ldflags='-s -w' -o mengyamonitor-backend .
"

# 或者使用多阶段构建
docker build -t mengyamonitor-backend -f Dockerfile.build .

验证编译结果

编译完成后，检查二进制文件：

# 检查文件类型
file mengyamonitor-backend

# 检查依赖（如果是静态链接，应该显示 "not a dynamic executable"）
ldd mengyamonitor-backend

# 检查 GLIBC 依赖（应该没有或很少）
objdump -T mengyamonitor-backend | grep GLIBC

编译参数说明

• CGO_ENABLED=0: 禁用 CGO，使用纯 Go 实现，不依赖系统 C 库
• -ldflags="-s -w": 减小二进制文件大小
  • -s: 省略符号表和调试信息
  • -w: 省略 DWARF 符号表

注意事项

1. 禁用 CGO 后，某些需要 C 库的功能可能不可用，但本项目不依赖 CGO
2. 静态链接的二进制文件会稍大一些，但兼容性更好
3. 如果必须使用 CGO，需要在目标系统上编译，或使用相同 GLIBC 版本的系统编译