配置Supervisor守护Hyperf需用绝对路径启动、禁用--daemonize、设startsecs≥10、显式声明environment，并配directory为项目根目录，同时启用Supervisor与Hyperf双日志机制。
单台服务器用 Supervisor 守护 Hyperf 进程，核心是让服务不中断、出错能自愈、日志可追溯。关键不在装得多快，而在配置是否贴合 Hyperf 的运行特性——它不是普通 PHP 脚本，而是基于 Swoole 的常驻进程，对路径、启动模式、启动耗时和环境变量都敏感。
必须用绝对路径 + 显式工作目录
Supervisor 默认工作目录不是你的项目根目录，command 中的 php 和 hyperf.php 都得写绝对路径，否则会找不到文件或加载失败。
- 先查 PHP 路径：
which php（比如/usr/bin/php或/servers/php/bin/php） - 再确认项目路径：
/var/www/my-hyperf-app或/servers/app/myproject - 最终 command 写成：
/usr/bin/php /var/www/my-hyperf-app/bin/hyperf.php start - 务必配 directory=：指向项目根目录，确保注解扫描、配置加载、runtime 目录写入都正确
禁用 --daemonize，设好 startsecs
Hyperf 默认启用守护进程模式（--daemonize），一旦开启，所有输出就脱离终端，Supervisor 的 stdout_logfile 就收不到任何内容，等于“静默失败”。
- command 后面不要加 --daemonize，保持前台运行
- startsecs 建议设为 10（不是默认的 1）：Hyperf 启动要加载容器、扫描注解、连 Redis/DB，1 秒太短，容易误判失败并反复重启
- autorestart=true + startretries=3 是基础组合，但没配对 startsecs 就形同虚设
日志双保险：Supervisor 日志 + Hyperf 自身日志
Supervisor 的日志只管启动阶段（比如端口被占、autoload 报错），真正业务日志得靠 Hyperf 自己写。
- Supervisor 配置 stdout_logfile 和 stderr_logfile，路径建议用
/var/log/supervisor/hyperf-out.log和/var/log/supervisor/hyperf-err.log - Hyperf 自身在
config/autoload/logger.php中配置文件驱动，把 default 日志写到runtime/logs/hyperf.log - 别在 command 后加
> /dev/null 2>&1，这会丢掉全部启动信息
环境与权限要收敛
Hyperf 依赖 Swoole、Redis、PDO 等扩展，这些得在 PHP 环境里就绪；运行用户也不建议用 root。
- PHP 配置检查：
memory_limit=1024M、swoole.use_shortname=off、Swoole ≥4.5 - user 设为普通用户（如
www-data或hyperf），提前给该用户项目目录读写权限 - 如有环境变量（如 APP_ENV=prod），通过 environment 字段注入：
environment=APP_ENV="prod",PATH="/usr/local/bin:/usr/bin"
