PHP flock 文件锁为什么仍会重复执行：锁模式、临界区与异常释放验证

两个 cron 进程几乎同时启动时，PHP 的 flock() 能让它们争用同一个锁文件，但“拿到锁”不等于“业务只执行一次”。最常见的重复执行，往往是锁只包住了写日志，或者脚本在拿锁前就做了副作用操作。

先看重复执行是怎么发生的

假设 /var/run/report.lock 被两个 PHP 进程使用。进程 A 先拿到锁，进程 B 在阻塞等待；只要 A 没有关闭句柄，B 就不能进入同一临界区。问题通常出在以下三处：两个进程打开的不是同一个路径，锁只覆盖了部分代码，或者把非阻塞失败当成了成功。

第一步：用同一个句柄建立独占锁

锁文件不需要保存业务内容，关键是路径稳定、句柄一直存活。下面的示例使用阻塞式独占锁；第二个进程会在 flock() 处等待。

这里的检查点是：两个进程打印的锁路径必须完全一致；$handle 不能在业务完成前被覆盖；try/finally 要覆盖所有可能抛出异常的代码。只调用 fclose() 也会在句柄关闭时释放锁，但显式 LOCK_UN 更容易让代码审查看出意图。

第二步：把真正的副作用放进临界区

如果脚本先生成临时文件、扣减额度或发送通知，随后才调用 flock()，即使最终写入被串行化，前面的副作用仍会重复。应先打开并取得锁，再读取状态、判断是否需要执行，最后一次性提交结果。

第三步：非阻塞模式必须处理失败分支

定时任务不想排队时，可以使用 LOCK_EX | LOCK_NB。这时 flock() 返回 false 只表示当前没拿到锁，不能继续执行。

$handle = fopen('/tmp/php-report.lock', 'c');
if ($handle === false || !flock($handle, LOCK_EX | LOCK_NB)) {
    if (is_resource($handle)) {
        fclose($handle);
    }
    error_log('report skipped: another process is running');
    exit(0);
}

try {
    rebuildReport();
} finally {
    flock($handle, LOCK_UN);
    fclose($handle);
}

验证时可以同时启动两个进程：一个在临界区里短暂等待，另一个应输出 report skipped 并且不产生业务写入。不要用“锁文件是否存在”判断占用状态，因为文件存在不代表句柄仍持有锁。

异常退出和回滚边界

PHP 进程结束时，操作系统会关闭句柄并释放文件锁；但已经写入的业务数据不会因为锁释放而自动回滚。因而需要把“锁释放”和“业务恢复”分开验证：先确认后续进程能取得锁，再检查上一次中断是否留下半成品。

生产脚本可以把结果写到临时文件，完成后再用同目录改名替换目标文件。这样即使进程在临界区中途退出，下一次运行也能根据临时文件和状态标记决定重做，而不是把一个半写入文件当成成功结果。

常见问题

锁文件需要每次执行前删除吗？

不需要。锁的占用状态属于句柄，不属于文件是否存在；反复删除锁文件反而可能让不同进程锁住不同 inode。

flock 能保证多台服务器互斥吗？

只有当所有进程访问同一个且锁语义可靠的共享文件系统时才可能成立。跨主机任务通常应使用数据库唯一约束或专门的分布式协调方案。

拿到 LOCK_EX 后还要检查业务状态吗？

要。文件锁只提供互斥，不知道任务是否已经完成；状态标记、幂等键或结果文件仍需要在锁内核对。

上线前的复查清单

• 锁路径由配置统一生成，所有进程实际打印值一致。
• 锁句柄覆盖完整副作用区，异常路径也能执行释放代码。
• 阻塞和非阻塞两种策略已分别验证，失败分支不会继续写业务数据。
• 模拟进程中断后，下一次执行能识别半成品并安全重做。