go version报错说明PATH未包含Go二进制路径，go env GOPATH为空或错误会导致构建失败；需以部署用户登录验证，检查~/.bashrc等配置是否正确source并含/usr/local/go/bin，GOROOT通常无需手动设置。
检查 go version 和 GOPATH/GOROOT 是否生效
很多部署失败其实卡在环境变量没生效。执行 go version 报错或版本过低，说明 Go 二进制没进 PATH；go env GOPATH 返回空或路径错误，会导致 go build 找不到依赖或缓存失效。
实操建议：
- 在目标机器上直接用部署用户（比如
www或app）登录后运行命令，别只在 root 下测 - 检查
~/.bashrc或/etc/profile.d/go.sh是否包含export PATH=$PATH:/usr/local/go/bin，且已source过 -
GOROOT一般不用手动设，除非你装了多个 Go 版本；GOPATH在 Go 1.16+ 已非必需，但若项目仍用go get安装依赖，就得确保它指向一个可写目录
验证 go build 能否成功产出可执行文件
编译失败往往比运行时崩溃更容易暴露问题，比如 CGO_ENABLED=0 时调用了 cgo、本地开发用的 macOS 专用 syscall 在 Linux 上不存在、或 go.mod 里引用了私有仓库但没配 git config。
实操建议：
- 在部署目标机器上，用和 CI/CD 完全一致的命令构建：
CGO_ENABLED=0 go build -o app ./cmd/server（如果服务不依赖 C 库） - 若必须启用 cgo（如用
net包解析 DNS），确保安装了gcc和libc-dev（Ubuntu）或glibc-devel（CentOS） - 检查
go list -m all输出是否干净——如果有unknown或replace指向本地路径，上线前必须改掉
启动前检查端口、权限、配置文件路径
服务启动瞬间报错 listen tcp :8080: bind: permission denied 或 open config.yaml: no such file or directory 是高频问题。这些不是代码 bug，而是部署上下文缺失。
实操建议：
- 用部署用户手动执行
ss -tlnp | grep :8080，确认端口未被占用，且该用户有权限监听（Linux 上1024以下端口需 root） - 配置文件路径写绝对路径，别依赖当前工作目录；用
ls -l /etc/myapp/config.yaml确认文件存在且部署用户有读权限 - 若服务要写日志到
/var/log/myapp/，提前创建目录并chown app:app /var/log/myapp
启动后立刻验证 HTTP 健康接口和基础连通性
跑起来不等于能用。./app && echo "ok" 成功只是第一步。得确认进程真在监听、HTTP 路由能响应、关键依赖（DB、Redis、下游 API）能连通。
实操建议：
- 加个最简健康检查端点，比如
GET /healthz，只返回{"status":"ok"}，不查 DB 不发请求 - 启动后立即 curl：
curl -s -f http://localhost:8080/healthz || echo "health check failed"，配合timeout 5s防卡死 - 若服务依赖 Redis，启动后跑一句
redis-cli -h 127.0.0.1 -p 6379 ping，别等第一个业务请求才暴露连接失败
最容易被忽略的是信号处理和日志重定向：上线脚本里用 nohup ./app > /dev/null 2>&1 & 启动，结果 panic 日志全丢；或者没捕获 SIGTERM，kill 进程时连接没 graceful shutdown。这些不会在“启动成功”里体现，但会在压测或流量突增时突然崩掉。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
