hyperf定时任务稳定后台运行的核心是通过supervisor守护php bin/hyperf.php start启动的常驻进程，自动拉起crontabdispatcherprocess；需在processes.php注册该进程、crontab.php开启enable并设时区，禁用nohup或系统crond调用。

Hyperf 定时任务在 Linux 环境下要稳定后台运行，核心是让 Crontab 调度进程随主服务长期、可靠、自动重启地驻留，而不是依赖手动前台运行或简单 nohup。它本身不依赖系统 crond，但需要自身进程被正确守护。

启动方式必须用常驻进程模式

Hyperf 的 hyperf/crontab 通过独立协程进程 CrontabDispatcherProcess 执行调度，该进程需与 HTTP/GRPC 主服务一同启动，并持续运行。
✅ 正确做法：启动整个 Hyperf 应用（含定时任务进程），而非单独跑定时任务。

php bin/hyperf.php start

该命令会自动拉起 CrontabDispatcherProcess，无需额外启动。

必须配置进程注册和启用开关

若定时任务没执行，90% 是这两处漏配：

• 在 config/autoload/processes.php 中注册调度器进程：

  return [
      \Hyperf\Crontab\Process\CrontabDispatcherProcess::class,
  ];

• 在 config/autoload/crontab.php 中开启功能：

  return [
      'enable' => true,
  ];

使用 Supervisor 实现真正的后台守护

php bin/hyperf.php start 默认前台阻塞。生产环境必须用进程管理工具实现：

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

• 自动拉起（崩溃后重启）
• 日志分离与轮转
• 启动/停止标准化

推荐 Supervisor（轻量、成熟、适配 Hyperf）：

1. 安装（Ubuntu/CentOS）：

   sudo apt install supervisor  # Debian/Ubuntu
   sudo yum install supervisor    # CentOS 7

2. 创建配置 /etc/supervisor/conf.d/hyperf.conf：

   [program:hyperf]
   command=/usr/bin/php /var/www/myapp/bin/hyperf.php start
   directory=/var/www/myapp
   user=www-data
   autostart=true
   autorestart=true
   startretries=3
   redirect_stderr=true
   stdout_logfile=/var/log/hyperf.log
   stdout_logfile_maxbytes=10MB
   stdout_logfile_backups=5

3. 加载并启动：

   sudo supervisorctl reread
   sudo supervisorctl update
   sudo supervisorctl start hyperf

避免常见陷阱

• ❌ 不要用 nohup php bin/hyperf.php start &：无崩溃恢复、日志混乱、信号处理弱。
• ❌ 不要单独用系统 crontab 调 php bin/hyperf.php start：会导致重复启动、端口冲突、进程失控。
• ❌ 不要遗漏 timezone 配置：config/autoload/crontab.php 中建议显式设置：

  'timezone' => 'Asia/Shanghai',

  否则 cron 规则可能按 UTC 解析，导致执行时间偏差。

验证是否生效

启动后检查：

• supervisorctl status 确认 hyperf 状态为 RUNNING
• 查看 hyperf.log 是否有类似日志：
  [INFO] Crontab manager started with 3 tasks
• 观察业务日志或数据库变更，确认任务按 rule 时间准确触发（注意：首次执行会等到下一个整点/整分，如 14:02:33 启动 * * * * * 任务，则首执行在 14:03:00）

不复杂但容易忽略。