Revel应用不可直接用revel run上生产,必须由systemd托管;因其开发模式依赖终端、热重载且无崩溃自愈能力,而nohup或&仅能临时避SIGHUP,无法解决日志丢失、无监控重启、TTY依赖等根本问题。

Revel应用不能靠 revel run 上生产,必须用 systemd 托管;否则进程一断就死、日志难查、重启无保障。
为什么不能直接 nohup revel run &
Revel 的 revel run 是开发模式:监听文件变化、热重载、输出调试日志到终端。后台运行时会踩中三个硬伤:
- 进程仍绑定当前 shell 会话,SSH 断连后可能被
SIGHUP终止 -
stdout/stderr没重定向,日志直接丢进/dev/null,journalctl里查不到任何记录 - 无崩溃自愈能力,进程挂了不会自动拉起,也没健康状态反馈
systemd 服务文件怎么写才靠谱
关键不是“能跑”,而是“可运维”——要支持日志归集、优雅退出、资源隔离和重启策略。示例 /etc/systemd/system/revel-app.service:
[Unit] Description=Revel Web Application After=network.target [Service] Type=simple User=revel WorkingDirectory=/opt/my-revel-app EnvironmentFile=/etc/revel-app/env.conf ExecStart=/opt/my-revel-app/revel-app Restart=on-failure RestartSec=5 KillSignal=SIGTERM TimeoutStopSec=30 StandardOutput=journal StandardError=journal [Install] WantedBy=multi-user.target
注意点:
-
Type=simple最稳妥;别用forking,Revel 不 daemonize -
KillSignal=SIGTERM+TimeoutStopSec=30是为配合 Revel v1.1.0 的优雅退出能力(它已支持SIGTERM处理) -
EnvironmentFile必须用绝对路径,敏感配置如DB_PASSWORD从这里注入,不硬编码进 service 文件 -
StandardOutput/StandardError=journal确保所有日志进journalctl -u revel-app,别漏掉
启动前必须确认的三件事
service 文件写完只是第一步,真正上线前必须验证:
- 二进制是否真的可执行:
chmod +x /opt/my-revel-app/revel-app,且是目标系统架构编译的(比如 Linux AMD64,不能用 macOS 构建后直接扔过去) - 配置文件路径是否正确:
conf/app.conf中mode=prod已设,watch=false、log.pretty=false、cookie.secure=true、cookie.samesite=Strict等生产项已启用 - 反向代理是否就位:Nginx 或 HAProxy 必须前置,负责 TLS 终止、超时控制、访问日志和异常流量过滤;Revel 自身不处理这些
常见故障信号和对应检查点
服务启动失败或日志为空?先看这几条:
-
journalctl -u revel-app -n 50 --no-pager—— 如果没输出,说明进程根本没起来,大概率是ExecStart路径错、权限不足、或EnvironmentFile里变量缺失 -
systemctl status revel-app显示failed但无详情?加--full参数再看,常暴露 Go 初始化 panic 或 DB 连接拒绝 - 服务启动后立即退出?检查
conf/app.conf是否误配了http.addr(比如绑127.0.0.1:9000却没配反向代理转发),或端口被占用 - 日志里反复出现
panic: runtime error?Revel v1.1.0 修复了日志模块递归调用问题,但若你还用更老版本,升级是刚需
最易被忽略的是:systemd 的 Restart=on-failure 对 SIGKILL 无效,而容器平台或 OOM Killer 就发 SIGKILL —— 所以得配 MemoryLimit 和 OOMScoreAdjust 防止静默死亡。











