Iris项目可直接编译为单个静态二进制文件部署：需禁用CGO（CGO_ENABLED=0）并指定目标平台，如CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp ./main.go；若依赖C库则需启用CGO并确保目标系统libc兼容；运行前须显式调用.Run()启动HTTP服务，并推荐使用systemd管理进程。
直接打包成单个静态二进制文件，上传到服务器运行即可——Iris 项目没有“部署依赖”这回事，它本质就是一个 Go 程序，编译完就能跑。
go build 静态编译必须关掉 CGO
默认 go build 在 Linux 上会动态链接 libc，导致二进制在某些精简系统（如 Alpine）上无法运行。必须显式禁用 cgo：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp ./main.go- 若项目用到了
net.Resolver（比如自定义 DNS）、sqlite3或其他需 C 绑定的库，就得设CGO_ENABLED=1，并确保目标服务器有对应版本的libc（通常是 glibc，Alpine 用的是 musl，不兼容） - macOS 或 Windows 编译时也需指定
GOOS和GOARCH，否则产出的是本地平台二进制
传输后不能直接 ./myapp 就完事
上传到服务器后，常见错误是：执行 ./myapp 后终端立刻退出、无日志、curl 无响应——大概率是没启动 HTTP server，不是代码挂了。
- Iris 应用初始化后（
iris.New()）不会自动监听端口，必须显式调用.Run(iris.Addr(":8080"))或.Listen(":8080") -
Run()是 v12+ 推荐方式，支持传入iris.Configuration控制超时、TLS、Graceful shutdown 等；Listen()是旧习惯，功能较弱 - 如果用了
iris.TLS()或自定义http.Server，必须用ConfigureHost()，否则 TLS 不生效
生产环境要用 systemd 管理进程
别用 nohup ./myapp & 或 screen —— 没日志轮转、不自动重启、不随系统启动，出问题难排查。
- 写
/etc/systemd/system/myapp.service，关键字段示例：
[Unit] Description=My Iris App After=network.target [Service] Type=simple User=www-data WorkingDirectory=/opt/myapp ExecStart=/opt/myapp/myapp Restart=always RestartSec=10 StandardOutput=journal StandardError=journal [Install] WantedBy=multi-user.target
sudo systemctl daemon-reload && sudo systemctl enable myapp && sudo systemctl start myapp
sudo systemctl status myapp；看实时日志：sudo journalctl -u myapp -f
路由参数和 query 参数别混用
上线后发现 ID 总是空？90% 是把路径参数当成了 query 参数取。
- 路径参数（如
/user/{id}）必须用ctx.Params().Get("id")，不是ctx.URLParam("id") -
ctx.URLParam()只解析 URL 查询字符串，例如/search?keyword=go→ctx.URLParam("keyword")返回"go" - 参数名大小写敏感：
{ID}定义的路由，ctx.Params().Get("id")返回空字符串，且不 panic，容易漏掉校验
最常被忽略的点：开发时用 go run main.go 能跑，不代表编译后的二进制也能跑——因为 go run 会自动加载当前目录下所有 .go 文件，而 go build 默认只编译显式列出的文件；如果有路由分散在多个文件里，得把它们全列进命令，或确保 main.go 所在包能 import 到全部逻辑。
