Shell脚本触发Gin项目构建上传需三步：先交叉编译（GOOS=linux GOARCH=amd64 go build -o ./dist/app），再scp上传，最后ssh执行chmod、杀旧进程、nohup启动，并注意SIGTERM优雅关闭与软链回滚机制。
怎么用 Shell 脚本触发 Gin 项目构建和上传
直接在 Shell 脚本里调用 go build 即可生成可执行文件，但要注意目标环境的 GOOS 和 GOARCH ——生产服务器通常是 Linux AMD64，本地开发机可能是 macOS 或 Windows。不加约束直接 go build 会导致二进制无法运行。
实操建议：
- 统一用交叉编译：在脚本中写死
GOOS=linux GOARCH=amd64 go build -o ./dist/app . -
./dist/目录需提前创建，否则go build报错no such file or directory - 如果项目依赖
CGO_ENABLED=1（比如用了 SQLite 或某些 C 绑定），得同步设置CGO_ENABLED=0或配好交叉编译工具链，否则构建失败 - 建议加
-ldflags="-s -w"减小二进制体积，避免调试信息泄露
怎么把编译好的 Gin 二进制推到远程服务器并启动
核心是三步：scp 传文件、ssh 执行停旧进程、ssh 启动新进程。不能只靠 scp + ssh systemctl start，因为 Gin 是纯二进制，通常不用 systemd 管理，而是用 nohup 或 supervisord。
常见错误现象：
- 上传后权限不够：
chmod +x ./dist/app必须在远程执行，本地chmod对 scp 过去的文件无效 - 端口被占：没杀旧进程就启动新实例，
bind: address already in use - 工作目录不对：Gin 默认读取当前目录下的
templates/或static/，远程启动时要用cd /path/to/app && ./app - 环境变量缺失：比如
GIN_MODE=release没传进去，导致日志暴露出调试信息
推荐最小可行命令组合：
scp ./dist/app user@prod-server:/opt/mygin/ ssh user@prod-server "cd /opt/mygin && chmod +x ./app && pkill -f './app' || true && nohup ./app > app.log 2>&1 &"
怎么让 Shell 脚本能自动处理 Gin 的热更新和回滚
Shell 本身不支持“热更新”，但可以通过版本打标 + 符号链接实现近似效果。关键不是替换二进制，而是切换软链指向哪个版本目录。
结构建议：
- 远程服务器上建
/opt/mygin/releases/v1.2.0/、/opt/mygin/releases/v1.2.1/等带版本号的子目录 - 每次部署都上传到新版本目录，再用
ln -sf releases/v1.2.1 current切换 - 启动命令始终走
/opt/mygin/current/app，这样回滚只需改一次软链 - 加个检查：部署前用
ssh ... 'ls -t /opt/mygin/releases | head -n 2'确认最新两个版本，方便快速回退
注意：current 软链必须在 nohup 启动前就存在，否则进程会 hold 住旧路径的 inode，删旧目录时可能出问题。
为什么 Gin 项目用 Shell 部署容易忽略 SIGTERM 处理
Gin 默认不响应 kill -15，直接 pkill -f 会强制终止，正在处理的 HTTP 请求可能中断，连接池来不及释放，数据库事务没提交完。
真正稳妥的做法是：在 Go 代码里加信号监听，配合 Shell 脚本发优雅关闭信号。
- Go 侧要注册
os.Interrupt和syscall.SIGTERM，调用engine.Shutdown() - Shell 脚本里别用
pkill，改用kill $(cat /opt/mygin/pidfile)，且先写 pid 文件 - 加超时等待：比如
timeout 10s bash -c 'while kill -0 $PID 2>/dev/null; do sleep 1; done'，等进程自然退出 - 没加 Shutdown 的 Gin 服务，就别指望 Shell 脚本能“优雅”——它只能粗暴杀，这是代码层的责任，不是脚本能补的
最常被跳过的点：开发者以为写了 engine.Run() 就万事大吉，其实 Run() 内部没做任何信号拦截，SIGTERM 默认行为就是 exit(1)，根本不会等请求结束。
