编程 flock 与 fcntl 的文件锁互不可见:/proc/locks 里 FLOCK、-1 的 pid 与 EOF 怎么读

2026-11-20 00:05:08

flock 与 fcntl 文件锁互不可见:用 /proc/locks 区分三类锁

现象:两个进程都声称拿到了锁

同一个 lock 文件,A 用 shell 的 flock 命令,B 用 PHP 的 flock() 或 Go 的 syscall.FcntlFlock(F_SETLK),两边都返回成功。这不是锁坏了,是两套机制互不冲突。

fcntl(2) man page 原话:Since kernel 2.0, there is no interaction between the types of lock placed by flock(2) and fcntl()。内核里是两套独立的冲突判定(fs/locks.c):

  • flock_locks_conflict:只在两个锁指向不同 struct file(filep)时才判定冲突。
  • posix_locks_conflict:要求 owner 不同(posix_same_owner 为真则不冲突),并且字节范围重叠。

先读 /proc/locks,别凭感觉猜

/proc/locks 显示当前文件锁与 lease,每行 8 列:

1: POSIX  ADVISORY  READ  5433 08:01:7864448 128 128
2: FLOCK  ADVISORY  WRITE 2001 08:01:7864554 0 EOF
3: OFDLCK ADVISORY  WRITE -1 08:01:8713209 128 191

列含义:

  1. 序号
  2. 类型,只有三种:FLOCK = flock(2) 创建的 BSD 锁(含 shell 的 flock 命令);POSIX = fcntl(2) 的 F_SETLK/F_SETLKW 或 lockf 创建的字节范围锁;OFDLCK = fcntl(2) 的 F_OFD_SETLK 创建的 open file description 锁
  3. ADVISORY 或 MANDATORY
  4. READ 或 WRITE(flock 里对应 LOCK_SH / LOCK_EX)
  5. 持有者 pid。OFDLCK 这一列恒为 -1,因为 OFD 锁不属于单个进程;Linux 4.14 之前的 bug 会显示最初加锁进程的 pid,按这个 pid 去找进程会找错
  6. major:minor:inode,十六进制。不是路径
  7. 起始偏移
  8. 结束偏移,EOF 表示锁到文件末尾并覆盖之后增长的部分。FLOCK 这两列恒为 0 与 EOF,因为 BSD 锁是整文件

要点:

  • 按 inode 反查路径:先 stat -c '%i %n' 得到 inode,或 find /目录 -inum N。lslocks(util-linux)直接给 PATH 列,比手写解析省事。
  • 自 Linux 4.9 起,/proc/locks 在 PID namespace 内只列本 namespace 进程的锁。容器里 cat /proc/locks 为空,不代表宿主上没有锁。
  • mandatory locking 实际用不上:内核里 LOCK_MAND 已移除,现代 Linux 上 fcntl 锁都是 advisory。

三类锁的“所有者”不同,才是锁没生效的主因

POSIX 锁的所有者是 (pid, inode):

  • 同一个进程对同一文件重复 SETLK 不会冲突,而是更新锁;
  • 该进程关闭指向该文件的任意一个 fd(包括 dup 和 fork 继承来的),它对该文件的全部 POSIX 锁一起释放;
  • fork 出的子进程不继承父进程的 POSIX 锁。

OFD 锁(3.15+)的所有者是 open file description:

  • 独立 open 得到两个 fd 就会冲突,即使在同一进程内;
  • 只有最后一个引用关闭才释放。

flock 锁整文件,所有者也是 open file description:dup 和 fork 共享同一把锁,重复加锁视为修改状态;另一个 open 得到的 fd 才是竞争者。

由此产生的经典误判:库里顺手 open 再 close 一下你的 lock 文件,你持有的 POSIX 锁就被隐式释放了,业务代码还以为自己持锁。

排查顺序

  1. grep -w /proc/locks,没有结果先排除 namespace/容器因素。
  2. lslocks -o COMMAND,PID,TYPE,MODE,PATH,看 TYPE 是 FLOCK 还是 POSIX——这一步就能确认两边是否根本不在同一套机制里。
  3. 反查 inode 到路径,确认是哪个文件。
  4. 用 F_GETLK 做探测(不是加锁):探测返回 F_UNLCK,但 flock 命令报占用,这就是两类锁不互通的直接证据。
  5. 确认持有进程状态:被 SIGSTOP 或卡在 IO 的进程不会释放锁,advisory 锁不会因为超时消失。

F_GETLK 只返回那一瞬间观察到的冲突,不能拿“先查没锁、再无锁写”当作加锁。

不能照搬的场景

NFS/SMB 上本地语义不成立:NFS 上 flock 要靠 NLM 或范围锁模拟,本地 flock 与 fcntl 的行为不能直接搬;很老的实现里 flock 在 NFS 上无效。

只锁一部分字节是 POSIX/OFD 的能力,flock 做不到。l_len=0 表示到 EOF 且包括后续增长范围,不是空范围。

落地

  • 跨语言共享一个锁文件时,先统一机制:PHP flock()、Go syscall.Flock、shell flock 是一套;Python fcntl.lockf、Java FileLock(Linux 上是 POSIX 锁)是另一套。混用等于没锁。
  • 需要同一进程内多线程互斥又要文件锁:用 OFD 锁(F_OFD_SETLK),POSIX 锁在同进程内是“更新”语义,天然不互斥。
  • 锁文件单独放一个路径,不要和业务数据文件共用,避免被其他库 open/close 顺手释放。
复制全文 生成海报 锁排查 文件锁 flock fcntl Linux 运维

推荐文章

程序员茄子在线接单