centos golang配置有哪些坑

在 CentOS 上配置 Golang（Go 语言环境）时，确实有一些常见的“坑”，尤其是新装系统、或者从 CentOS 7 迁移到 CentOS 8/Stream 时。下面按安装 → 环境 → 编译 → 运行的顺序总结。

一、安装方式相关的坑

1️⃣ 不要直接用 yum install golang

yum install golang

坑点：

• CentOS 7 默认仓库的 Go 非常旧（常是 1.13 甚至更早）
• 很多现代项目要求 Go ≥ 1.18 / 1.20

✅ 推荐做法： 从官方下载：

wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz

二、环境变量配置的坑（最常见）

2️⃣ GOROOT 和 PATH 配错

很多人这样写：

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

⚠ 坑点：

• CentOS 默认 shell 是 bash
• 写在 ~/.bashrc 但用 sudo 或 cron 运行时不生效

✅ 正确示例（普通用户）

# ~/.bashrc
export PATH=$PATH:/usr/local/go/bin

✅ 验证

source ~/.bashrc
go version

3️⃣ root 用户和普通用户环境不一致

sudo go version
# command not found

✅ 解决：

• 给 root 也配一份环境
• 或统一用普通用户编译

三、GOPATH / Go Modules 的坑

4️⃣ 还停留在 GOPATH 时代

老教程：

export GOPATH=$HOME/go

现代 Go（1.16+）默认 Go Modules

✅ 推荐：

go env -w GO111MODULE=on
go env -w GOPROXY=https://proxy.golang.org,direct

国内机器：

go env -w GOPROXY=https://goproxy.cn,direct

5️⃣ 在 $GOPATH/src 外不能 go build

旧项目报错：

cannot find package

✅ 解决：

• 使用 Go Modules
• 或项目放在 ~/go/src/xxx

四、CentOS 特有系统问题

6️⃣ glibc 版本太低（CentOS 7）

Go 程序本身没问题，但：

• CGO 依赖系统库
• 使用 sqlite / openssl 时容易炸

⚠ 报错示例：

version `GLIBC_2.28' not found

✅ 建议：

• 尽量 CGO_ENABLED=0

CGO_ENABLED=0 go build

7️⃣ CentOS 8 / Stream 已停止维护

CentOS 8 官方源没了：

Failed to download metadata

✅ 解决：

• 换 Vault 源
• 或直接用 Rocky / AlmaLinux

五、防火墙 / 端口坑（运行阶段）

8️⃣ Go Web 服务外部访问不了

go run main.go
# 本地能访问，外网不行

✅ 检查：

firewall-cmd --list-ports
firewall-cmd --add-port=8080/tcp --permanent
firewall-cmd --reload

并确认监听：

0.0.0.0:8080  # 而不是 127.0.0.1

六、权限 & systemd 坑

9️⃣ 用 systemd 启动失败

错误：

exec: "go": executable file not found

✅ systemd 不会读 .bashrc

解决：

• 用编译好的二进制
• 或在 service 里写绝对路径

ExecStart=/usr/local/go/bin/go run /opt/app/main.go

七、总结速查表

如果你愿意，可以告诉我：

• CentOS 版本（7 / 8 / Stream）
• Go 版本
• 是 开发环境 还是 生产部署

我可以给你一套最合适的配置方案。