ThinkPHP 8 定时任务无内置并发控制，易因执行超时导致多实例并发；需手动实现文件锁、数据库标记、Redis分布式锁或进程检测四种方案，并注意权限、异常释放与环境一致性。
ThinkPHP 8 的定时任务本身不内置并发控制机制，它依赖操作系统级 Cron 触发命令执行，而每个 Cron 条目是独立进程。这意味着：如果任务执行时间长于调度间隔（比如每分钟跑一次，但单次耗时 90 秒），就可能产生多个实例同时运行——轻则重复处理数据，重则引发数据库锁、文件冲突或资源争抢。
为什么并发问题在 TP8 中特别容易被忽略？
因为 TP8 的 think schedule:run 是“被动触发器”，它只负责检查当前时刻有哪些任务该执行，然后调用对应命令；它不做进程锁、不排队、不判断前序是否完成。开发者常误以为“写了 ->withoutOverlapping() 就万事大吉”，但这个方法仅在 Laravel 风格的调度器中生效，ThinkPHP 8 原生不支持该语法。所有并发控制必须由你手动实现。
四种可靠且可落地的并发控制方案
1. 文件锁（推荐用于简单任务）
适用于清理缓存、日志归档等轻量级、无状态操作。
- 在
execute()开头生成唯一锁文件（如runtime/lock/clean_cache.lock） - 用
flock()尝试加写锁，失败则直接退出并输出提示 - 成功后记录 PID 和启动时间，任务结束前释放锁
- 示例片段：
$lockFile = RUNTIME_PATH . 'lock/clean_cache.lock';<br>$fp = fopen($lockFile, 'c');<br>if (!flock($fp, LOCK_EX | LOCK_NB)) {<br> $output->writeln('任务正在运行，跳过本次执行');<br> return self::FAILURE;<br>}<br>// 执行业务逻辑<br>flock($fp, LOCK_UN); fclose($fp);
2. 数据库标记表（推荐用于关键业务）
适合订单同步、用户数据更新等需强一致性的场景。
立即学习“PHP免费学习笔记（深入）”；
- 新建表
task_lock，字段包括task_name（主键）、started_at、pid、status（running/done） - 执行前用
INSERT ... ON DUPLICATE KEY UPDATE尝试插入任务名 - 仅当影响行数为 1（即首次插入成功）才继续执行；否则查
started_at判断是否超时（如 >10 分钟），超时则更新为 running 并接管 - 任务结束前务必更新
status = 'done'，避免死锁
3. Redis 分布式锁（推荐多服务器部署）
当项目部署在多台机器、共用同一套 Cron 时必须使用。
- 用
SET task:clean_cache "pid_12345" EX 600 NX获取带过期的锁 - 成功则执行任务；失败则 sleep 后重试最多 3 次，或直接退出
- 任务结束前用 Lua 脚本原子性地校验并删除锁（防止误删他人锁）
- 注意：Redis 连接需配置超时和重试，避免锁服务不可用导致整个任务瘫痪
4. 系统级进程检测（适合 CLI 命令直调）
当你的任务是通过 crontab 直接调用 php think xxx，而非走 schedule:run 时可用。
- 在
execute()开头执行 shell 命令：ps aux | grep "think xxx" | grep -v grep | wc -l - 若结果 >1，说明已有同名进程在跑，直接 exit
- 优点是无需额外依赖；缺点是跨平台兼容性差（Windows 不适用），且无法区分不同参数的同名命令
避坑要点：三个必须检查的细节
• 锁路径权限：确保 runtime/lock/ 目录存在且 Web 用户与 Cron 用户（通常是 www-data 或 nobody）都有读写权限，否则锁文件创建失败却静默跳过
• 异常退出不释放锁：务必把 flock 释放、数据库状态更新、Redis 删除锁等操作放在 try...finally 或 register_shutdown_function() 中，防止 PHP Fatal Error 导致锁残留
• 环境一致性：Cron 默认环境变量精简（无 PATH、无 Composer autoload），建议在 crontab 中显式指定 PHP 路径和项目根目录，例如：*/5 * * * * cd /var/www/myapp && /usr/bin/php think cron:clean-cache >> /var/log/cron-clean.log 2>&1
