CentOS环境下用Golang打包，经常会遇到一些让人头疼的问题。下面整理了几类最典型的“坑”，以及对应的解决方案，希望能帮你省点调试时间。

CentOS中Golang打包的常见问题

1. glibc版本不匹配

跨CentOS版本编译时，比如在CentOS 8上编译目标给CentOS 6用，很容易因为glibc版本差异翻车。运行时常见报错是“GLIBC_2.28 not found”。

原因很简单：高版本glibc编译出来的二进制，拿回低版本系统上跑，系统里没有对应的动态库版本。

怎么破？最省心的办法是用Docker，拉一个和目标系统版本一致的镜像，比如centos:6，在里面编译。

或者干脆静态编译。设置CGO_ENABLED=0，让二进制不依赖系统动态库，迁移起来就灵活多了。

2. 缺少依赖库

编译时如果提示“cannot find -lcurl”之类的，八成是系统里缺少对应的开发库。

比如用到了libcurl，就需要先装libcurl-devel。其他依赖同理，找对应的-devel包用yum装上就行：

• sudo yum install libcurl-devel

提前把依赖配齐，编译时才能一路绿灯。

3. exec格式错误

在Linux服务器上运行打包好的二进制文件，却提示“exec format error”，这通常不是文件坏了，而是编译时没指定目标平台。

编译前一定要设置好GOOS和GOARCH。比如：

• export GOOS=linux
• export GOARCH=amd64
• go build

否则默认会按当前平台编译，但跨平台传过去就可能出问题。

4. 循环导入错误

代码里包A导入了包B，包B又导回包A，编译器会直接报“import cycle not allowed”。

解决办法只有一条路：重构模块划分。把公共的逻辑抽出来，放到一个新包里，切断循环依赖。

设计上尽量保持依赖关系是单向的，能省很多麻烦。

5. 二进制文件体积过大

Go的静态编译默认会把所有依赖都打包进去。一个简单程序，动不动就几MB甚至几十MB。

其实可以通过编译选项瘦身。加上-ldflags="-s -w"，其中-s忽略符号表，-w忽略调试信息，体积能明显降下来。

• go build -ldflags="-s -w" -o myapp

6. 依赖管理问题

用Go Modules时，依赖下载失败、版本冲突、go.mod文件不一致，都是常见状况。

可以按下面的顺序排查：

• 先试试go mod tidy，它会自动下载缺失的依赖，同时清理掉没用的。
• 如果版本冲突，手动指定版本：go get package@version。
• 再不行就清一下模块缓存：go clean -modcache，然后重新下载。

7. 文件权限问题

把二进制文件传到服务器上，运行报“cannot execute binary file”或“Permission denied”，多半是没给执行权限。

• chmod +x myapp

上传文件时用scp -p可以保留文件权限，省得每次手动改。

8. 环境变量配置错误

如果go命令找不到，或者编译时提示依赖路径不对，大概率是GOROOT、GOPATH、PATH没设对。

以Golang安装在/usr/local/go、工作空间在~/go为例，在~/.bashrc或~/.bash_profile里加上：

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

然后执行source ~/.bashrc生效。

配置正确后，基本就不会再被环境变量绊倒了。