thinkphp定时任务失败主因是cron环境变量缺失导致命令找不到，应显式写全路径；timer:run需常驻运行而非cron反复调用，推荐supervisord守护；cli下数据库连接需注意localhost与127.0.0.1差异及.env加载问题。
ThinkPHP定时任务执行失败，cron 日志显示“command not found”
根本原因通常是 cron 环境变量与当前用户 shell 不一致，导致找不到 php 命令或项目路径解析错误。系统级 cron 默认只加载极简环境（PATH=/usr/bin:/bin），不会读取 ~/.bashrc 或 /etc/profile。
实操建议：
- 在
cron条目中显式写全路径，例如：/usr/local/bin/php /var/www/myapp/think timer:run --only=app\job\SendEmail - 用
which php和pwd确认实际路径，别直接抄终端里php的别名或软链 - 加
> /tmp/cron_sendemail.log 2>&1捕获输出，避免静默失败 - 如果用宝塔、AMH 等面板，注意其 cron 界面可能自动封装了环境，但底层仍受限于系统 cron 用户权限（常为
www或nobody）
定时任务跑着跑着就停了，ps aux | grep think 找不到进程
ThinkPHP 的 timer:run 是长进程模式，不是每次 cron 触发都新建一个——它本意是常驻后台持续调度。若你用 * * * * * cd /path && php think timer:run 这种方式，等于每分钟启一个新进程，旧进程未退出就会堆积，或被系统 OOM kill，也可能因端口/文件锁冲突直接报错退出。
正确做法是只启动一次，并用进程守护工具盯住它：
- 用
nohup php think timer:run > /dev/null 2>&1 &启动后记录 PID，但不推荐——无法自动拉起 - 更可靠的是用
supervisord：配autostart=true、autorestart=true、startsecs=5，并设user=www匹配 Web 服务权限 - 若服务器没装
supervisord，可用 systemd 服务单元，注意Type=simple+Restart=always，且WorkingDirectory必须设为项目根目录 - 切勿在
crontab里反复调用timer:run——这是最常见误用
timer:run 启动报错 Connection refused 或 SQLSTATE[HY000] [2002]
这说明定时任务进程启动时，数据库连接不可达。和 Web 请求不同，timer:run 是 CLI 模式，读取的是 config/database.php 中的配置，但容易忽略几个关键点：
- CLI 下 MySQL host 若写
localhost，会走 socket 连接；而 Web 通常走 TCP。若 socket 文件路径不对（如 Docker 容器里没挂载），就直接拒连。改用127.0.0.1强制走 TCP - 数据库账号权限限制了连接来源，CLI 进程的
host可能被识别为localhost或空字符串，而 Web 是通过 Nginx 转发，实际来源可能是127.0.0.1——检查账号是否允许从对应 host 登录 - Redis、消息队列等中间件同理，CLI 环境下
redis://127.0.0.1:6379和redis://localhost:6379行为可能不同 - 配置里用了
env('DB_HOST')？确保.env在 CLI 下能被正确加载（ThinkPHP 6+ 默认支持，但自定义入口或容器部署时可能被绕过）
任务卡死、重复执行或时间漂移，timer:run 的并发与调度精度问题
timer:run 底层基于 PHP 的 pcntl 和 usleep 轮询，不是真正的异步调度器。它每秒检查一次任务队列，靠单进程串行执行，一旦某个任务耗时超过 1 秒，后续任务就会延迟甚至堆积。
- 避免在定时任务里做同步 HTTP 请求、大文件处理、阻塞式 sleep —— 改用队列（如 think-queue）异步投递
- 不要依赖
timer:run实现毫秒级精度任务；它适合分钟级（*/5 * * * *）或小时级调度 - 多个任务共用一个
timer:run进程时，一个任务异常崩溃（未 try-catch）会导致整个进程退出，所有后续任务停摆——务必在任务逻辑里兜底异常 - 高并发场景下，建议拆成多个独立守护进程（如
php think timer:run --only=job1、--only=job2），用不同 supervisord program 分开管理
真正麻烦的从来不是怎么启起来，而是没人检查 supervisord 自己有没有被 systemd 拉起来，或者 timer:run 进程 stdout/stderr 是否被重定向到满的磁盘分区上。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
