必须同时指定GOOS、GOARCH和GOARM(如GOOS=linux GOARCH=arm GOARM=7),并设CGO_ENABLED=0,否则编译出的二进制在ARM设备上会报exec format error或运行时panic;ARM部署还需调优SQLite连接池、WAL模式、systemd内存限制及Nginx参数。

编译时必须指定 GOARCH=arm GOARM=7 GOOS=linux
直接在 x86 机器上 go build 出来的二进制在 ARM 服务器上根本跑不起来,会报 exec format error。必须显式交叉编译:
-
GOARCH=arm GOARM=7 GOOS=linux go build -o gin-arm—— 适用于大多数 ARMv7 设备(如旧款树莓派、银河麒麟 aarch64 兼容层) -
GOARCH=arm64 GOOS=linux go build -o gin-arm64—— 适用于 Cortex-A53/A72/A76 等 64 位芯片(如树莓派 4/5、飞腾 D2000、鲲鹏 920) - 若项目含 cgo 依赖(如 SQLite 的某些构建标签),需加
CGO_ENABLED=0避免链接失败;否则要配好 ARM 的交叉编译工具链
SQLite 连接池和 WAL 模式必须手动调优
在 ARM 终端或低资源嵌入式设备上,sql.Open("sqlite3", "db.sqlite") 默认行为极易触发 database is locked 或冷启动失败。这不是驱动 bug,而是 database/sql 连接池太“积极”:
- 必须显式设置
db.SetMaxOpenConns(1)和db.SetMaxIdleConns(1) - DSN 中强制启用 WAL 并设超时:
db.sqlite?busy_timeout=5000&journal_mode=WAL - 数据库路径务必用绝对路径(如
/data/app/db.sqlite),避免因工作目录不确定导致 open 失败
启动后不能直接前台运行,得用 systemd 或 nohup 管理
ARM 服务器(尤其是 Armbian、银河麒麟等)没有桌面环境,前台运行进程随终端退出就挂了。别用 ./gin-arm 手动敲:
- 推荐写 systemd service:把二进制放
/usr/local/bin/gin-arm,配置Restart=always、RestartSec=5,并用StandardOutput=journal接管日志 - 临时调试可用
nohup ./gin-arm > app.log 2>&1 &,但注意nohup不处理崩溃重启 - 务必检查
PORT环境变量是否被正确传入(比如Environment=PORT=8080),Gin 默认只监听 :8080,没设 PORT 就可能绑错地址
Nginx 反向代理要按 ARM 特性调参
别直接套用 x86 的 nginx.conf。ARM 芯片缓存小、IO 吞吐弱,盲目开高并发反而拖垮:
-
worker_processes auto在单核 ARM 上会起多个 worker,争抢 CPU,建议写死为1 -
worker_connections建议从 512 起步,压测后再调;ARM 设备文件描述符默认限制低,记得同步改/etc/security/limits.conf -
sendfile on可以开,但aio on在多数 ARM Linux 内核(如 4.19/5.10)上支持不稳,建议关掉 - SSL 场景下,
ssl_buffer_size 4k比默认 16k 更适配 ARM 的 L1/L2 缓存大小
MemoryLimit。很多银河麒麟或 Armbian 系统默认限制进程内存,而 Gin + SQLite 在 WAL 模式下会隐式占用额外页缓存,不设 MemoryLimit=512M 可能被 OOM killer 杀掉——这和代码无关,纯属部署时没看系统资源策略。


















