如何在Python中通过filelock实现跨进程文件互斥锁-Python教程-PHP中文网

FileLock能真正跨进程加锁，但必须用FileLock（非SoftFileLock），且所有进程需共享同一绝对路径的锁文件；Windows对锁文件删除更敏感，NFS或权限问题易致锁失效。

如何在python中通过filelock实现跨进程文件互斥锁

filelock 能否真正跨进程加锁

能，但必须用 FileLock（而非 SoftFileLock），且锁文件路径需被所有进程共享。Windows 和 Linux 下行为一致，但 Windows 对文件删除更敏感——锁文件不能被其他进程意外删掉，否则会抛 FileNotFoundError。

常见误判是：本地测试时用多线程模拟多进程，结果看似正常，实际部署后失效。因为 threading.Lock 无法跨进程，而 filelock 的跨进程能力依赖真实文件系统状态。

FileLock 底层靠 os.open(..., os.O_EXCL | os.O_CREAT) 实现原子性建锁，这是 POSIX 和 Windows（自 Python 3.8+）都支持的
SoftFileLock 只做进程内标记，不写磁盘，完全不跨进程，别用它解决跨进程问题
锁文件路径建议用绝对路径，避免各进程因工作目录不同导致锁文件位置错位

正确初始化和使用 FileLock 的关键步骤

核心是「同一路径 + 正确上下文管理」。漏掉任一环节都会导致锁失效或死锁。

锁对象必须用同一个 FileLock 实例（或至少指向同一锁文件路径），不能每个进程 new 一个不同路径的锁
必须用 with 语句进入临界区，手动调 acquire() / release() 容易忘记释放或异常跳过
锁文件本身无需预先存在，FileLock 会自动创建；但父目录必须存在且可写，否则报 FileNotFoundError 或 PermissionError

示例：

from filelock import FileLock
lock_file = "/tmp/myapp.lock"  # 所有进程共用这个路径
with FileLock(lock_file):
    # 这里读写共享文件、更新数据库状态等
    with open("/shared/data.txt", "a") as f:
        f.write("done by pid {}\n".format(os.getpid()))

为什么有时锁看起来没生效？排查重点

最常踩的坑不是代码写错，而是环境或权限层面的问题。

Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖，强化 Python 脚本。

下载

Linux 下检查锁文件所在文件系统是否为 tmpfs 或 NFS：tmpfs 支持 O_EXCL，但某些旧版 NFS 不支持原子创建，会导致锁退化为“竞态检测”，失去互斥性
多个 Python 进程是否用了不同用户运行？锁文件权限可能限制了其他用户访问，观察 ls -l /tmp/myapp.lock 的 owner 和 mode
进程崩溃未正常退出时，锁文件可能残留。FileLock 不自动清理，下次启动会卡在 acquire() —— 可加超时：with FileLock(lock_file): → with FileLock(lock_file).acquire(timeout=5):
不要在锁内做耗时操作（如网络请求、长循环），否则其他进程会长时间阻塞；把临界区缩到最小，只包真正需要互斥的 IO 或状态变更