FrankenPHP进程意外退出后，容器部署应使用Docker的restart: unless-stopped策略兜底并配合健康检查；原生部署推荐systemd托管，配置Restart=always、KillMode=process等参数；不推荐Supervisor，因其与FrankenPHP运行模型不兼容易引发误判重启。
FrankenPHP 进程意外退出后，不能依赖 Supervisor 或 systemd 管理其主进程——因为 FrankenPHP 本身就是一个自包含、常驻内存的单二进制应用服务器（含 Caddy + PHP 运行时），它的设计哲学是“自己管好自己”。所以自动重启机制要分两层理解：容器化部署下的重启策略 和 原生二进制部署下的韧性保障。
✅ 容器部署：用 Docker 的 restart 策略兜底
这是生产中最常用、最可靠的方式。FrankenPHP 官方推荐以 Docker 方式运行，此时应直接利用 Docker 原生能力：
-
在
docker-compose.yml中配置：services: php: image: dunglas/frankenphp restart: unless-stopped # 其他配置（端口、卷等）...
-
unless-stopped表示：除非你手动执行docker stop，否则进程崩溃、OOM、panic 或 SIGSEGV 导致退出，Docker 都会自动拉起新实例。立即学习“PHP免费学习笔记（深入）”；
-
可选增强：加健康检查，避免“假活”（进程在但 HTTP 服务无响应）：
healthcheck: test: ["CMD", "curl", "-f", "http://localhost/health"] interval: 30s timeout: 5s retries: 3 start_period: 40s
⚠️ 注意：需在项目中提供
/health路由（如返回200 OK），FrankenPHP 本身不内置该接口。
✅ 原生二进制部署：靠 systemd 服务文件实现守护
若未使用 Docker，而是直接在 Linux 上运行 frankenphp 二进制文件，推荐用 systemd 托管：
- 创建服务文件
/etc/systemd/system/frankenphp.service：[Unit] Description=FrankenPHP Web Server After=network.target
[Service] Type=simple User=www-data WorkingDirectory=/var/www/html ExecStart=/usr/local/bin/frankenphp server --config /var/www/html/Caddyfile Restart=always RestartSec=5 StartLimitInterval=60 StartLimitBurst=3 KillMode=process LimitNOFILE=65536
[Install] WantedBy=multi-user.target
- 关键点说明： - `Restart=always`：任何退出都重启（包括正常 exit，适合常驻服务） - `RestartSec=5`：失败后 5 秒再试，避免高频闪退打满日志 - `KillMode=process`：只杀主进程，不误杀子进程（如 PHP worker） - `LimitNOFILE`：防止高并发下文件描述符耗尽导致崩溃 - 启用并启动： ```bash sudo systemctl daemon-reload sudo systemctl enable frankenphp sudo systemctl start frankenphp
❌ 不推荐的做法：用 Supervisor 管理 FrankenPHP
FrankenPHP 内置了完整的 HTTP 服务器和 TLS 终止能力，与 Nginx+PHP-FPM 架构完全不同。
Supervisor 试图用 autorestart=unexpected 监控 stderr 输出来判断异常，但 FrankenPHP 的日志默认走 stdout/stderr，且 Caddy 日志级别较细（含 info/warning），极易被误判为“非正常退出”，造成频繁重启循环。
简单说：Supervisor 和 FrankenPHP 的运行模型不兼容，强行套用反而引入不稳定。
? 排查退出原因比盲目重启更重要
FrankenPHP 退出通常不是随机事件，常见真实原因包括：
-
PHP 应用代码触发 fatal error 或 segfault（尤其扩展不兼容时）
→ 查journalctl -u frankenphp -n 100或容器日志，关注最后几行的 panic/crash 信息 -
Caddyfile 配置错误（如 TLS 证书路径不存在、端口被占）
→ 启动时加--debug参数：frankenphp server --debug --config Caddyfile -
系统资源不足（内存耗尽触发 OOM killer）
→dmesg -T | grep -i 'killed process'看是否出现frankenphp被 kill -
PHP 扩展冲突或版本不匹配（如 opcache + JIT 在某些 PHP 8.3 下不稳定）
→ 临时禁用扩展测试：php -d extension=opcache.so -m | grep opcache
FrankenPHP 的设计理念是“开箱即稳”，自动重启只是最后一道防线。真正减少退出，靠的是合理配置、规范编码、及时更新版本，而不是堆监控工具。
