thinkphp 5.1定时任务需手动加锁，因框架无内置文件锁机制；推荐使用flock（严格五步流程）或redis分布式锁（set nx ex），避免并发冲突。
ThinkPHP 5.1 本身不内置文件锁机制，定时任务若直接由 Crontab 调用命令行指令（如 php think cron:sync），多个实例同时触发时极易出现并发冲突——比如重复扣库存、日志错乱、token 覆盖写入失败等。这不是框架 bug，而是未加防护的典型并发问题。
定时任务必须手动加锁，不能依赖框架自动处理
TP5.1 的 think\console\Command 类完全不介入文件锁逻辑。Cache::lock() 在 5.1 中尚未引入（那是 6.1+ 的特性），FileCache 驱动也从不自动调用 flock。你写的任何耗时操作，只要涉及共享资源（如写配置文件、更新 token、修改计数器），就必须自己套一层文件锁。
- 别信“只跑一次”的错觉：Crontab 每分钟拉起一个新 PHP 进程，每个进程都独立执行，彼此无感知
- 不要用
file_put_contents($file, $data, FILE_APPEND)替代锁：它不是原子操作，多进程写同一文件仍会截断或覆盖 - 避免在
configure()或构造函数里提前打开锁文件：此时命令参数还没解析，且锁生命周期难控制
flock 实现要严格遵循「开—锁—做—放—关」五步
常见失效原因不是函数不会用，而是流程断裂。正确写法示例：
- 用
fopen($lockPath, 'c')创建并打开锁文件（c模式安全，不截断已有内容） - 立即
flock($fp, LOCK_EX | LOCK_NB)：非阻塞尝试独占锁，失败直接exit(0) - 临界区内只做必要操作（如查 DB、调 API、写文件），禁止 sleep、远程请求、大循环
- 务必显式
flock($fp, LOCK_UN)，再fclose($fp)；不要依赖进程退出自动释放 - 锁文件路径建议用绝对路径，如
RUNTIME_PATH . 'lock/cron_sync.lock'，避免相对路径在 Crontab 下失效
Linux Crontab 环境下特别注意三点
TP5.1 定时任务常部署在 Linux + Crontab 组合中，以下细节极易踩坑：
-
PHP 解释器路径必须绝对：Crontab 不继承 shell 环境变量，写
/usr/bin/php而非php -
工作目录需显式切换：Crontab 默认在 root 目录执行，要用
cd /path/to/project && /usr/bin/php think ... - 权限与 SELinux 限制：确保 runtime/lock/ 目录对运行 Crontab 的用户（如 www-data）可读写，SELinux 启用时可能拦截 flock 系统调用
替代方案：比文件锁更稳的轻量级选择
如果你的任务需要跨服务器、或运行在 Docker/NFS 环境，flock 可能失效（它依赖本地文件系统语义）。此时可退而求其次：
- 用 Redis 实现分布式锁：
SET lock:sync EX 300 NX，配合DEL原子释放，TP5.1 可通过think\Cache访问 Redis - 数据库唯一索引兜底：建一张
task_lock表，字段含task_name（UNIQUE）和expire_at，插入成功即获锁 - 进程级标记（单机适用）：
file_put_contents(RUNTIME_PATH.'pid/sync.pid', getmypid())，执行前检查 pid 是否存活，但需自行清理僵尸进程
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
