必须完成可执行文件构建、依赖静态打包、运行时环境校验和启动后连通性验证四步闭环，否则服务可能panic或静默失败；需用go build -ldflags="-s -w"生成无依赖二进制，CGO_ENABLED=0禁用cgo确保静态链接，通过ss/telnet/db.Ping验证MySQL连通性，再nohup守护启动并检查日志与health接口。
要在服务器上稳定运行 XORM 框架驱动的 Go 应用，不能只写好代码就直接 go run，必须完成可执行文件构建、依赖静态打包、运行时环境校验和启动后连通性验证四步闭环。缺少任一环节，服务可能在部署后立即 panic 或静默失败。
编译生成无依赖可执行文件
进入项目根目录，执行以下命令生成 Linux 二进制文件：
go build -ldflags="-s -w" -o server ./main.go
其中 -s 去除符号表，-w 去除 DWARF 调试信息，两者结合可使二进制体积缩小 30%～50%，且不依赖本地 GOPATH 或 Go 环境。这一步生成的 server 文件是自包含的，【无需在目标服务器安装 Go 编译器或 GOPATH】。
若项目使用了 cgo（如 MySQL 驱动默认启用 cgo），需显式禁用以确保纯静态链接：
CGO_ENABLED=0 go build -ldflags="-s -w" -o server ./main.go
否则二进制会动态链接 libc，在 Alpine 等精简镜像中直接报错 "no such file or directory"。
检查数据库连接参数与服务可达性
方法一：用 netstat 或 ss 快速验证端口通断
ssh user@prod-server && ss -tuln | grep :3306
若无输出，说明 MySQL 未监听或防火墙拦截；若有输出但状态非 LISTEN，可能是 mysqld 进程未启动。
方法二：用 telnet 测试 TCP 层连通性（无需 MySQL 客户端）
telnet 127.0.0.1 3306
成功时显示 “Connected to 127.0.0.1” 并停住光标；失败则提示 “Connection refused” 或超时。这比 mysql -h 命令更底层，能排除 DNS、客户端权限等干扰项。
方法三：在 Go 启动前插入最小化连接探针（推荐嵌入 main 函数首行）
db, err := sql.Open("mysql", "root:123456@tcp(127.0.0.1:3306)/demo?timeout=3s")
if err != nil { log.Fatal("DSN 解析失败:", err) }
if err = db.Ping(); err != nil { log.Fatal("MySQL 连接失败:", err) }
这行代码必须放在 xorm.NewEngine() 之前执行，否则 xorm 初始化失败时错误堆栈冗长难定位。
启动并守护进程
第一步：赋予执行权限
chmod +x server
第二步：以后台方式启动（不占用终端）
nohup ./server > app.log 2>&1 &
第三步：检查进程是否存活
ps aux | grep server | grep -v grep
第四步：查看日志确认初始化完成
tail -n 20 app.log | grep -i "sync\|engine\|started"
若日志中出现 "Sync2 success" 或 "server started on :8080" 类字样，说明 XORM 表同步与 HTTP 服务均已就绪。此时可发起 curl http://localhost:8080/health 检查业务层健康接口。
