php 7.1 的 flock() 在 nfs 上基本不可靠,因 nfsv3 缺乏内核级强制锁,flock() 退化为本地建议锁,多机间无法同步;nfsv4 需服务端启用 lockd、客户端挂载加 noac/actimeo=0 参数,并验证锁真实生效。

PHP 7.1 的 flock() 在 NFS 共享存储上基本不可靠——这不是你代码写错了,而是 NFS(尤其 v3)和 flock() 本身的设计冲突导致的锁竞争失效、脏读甚至进程假死。核心问题在于:NFS 的文件锁机制与本地文件系统不一致,且 PHP 的 flock() 是建议性锁,依赖底层支持,而 NFSv3 默认用 flock 语义,但很多 PHP 应用实际走的是 fcntl 锁路径,两者互不识别。
为什么 NFS 上 flock 失效是常态
NFSv3 不提供内核级强制锁,flock() 在其上退化为客户端本地锁,不同机器上的 PHP 进程根本看不到彼此的锁状态;NFSv4 虽统一了锁协议,但需服务端开启 nfsd 的 rpcbind 和 lockd,且客户端 mount 时必须加 noac 或 actimeo=0 等参数,否则缓存会掩盖锁变化。PHP 7.1 默认不校验锁是否真正生效,返回 true 只代表本地调用成功,不代表其他节点已同步锁定。
避免脏读:不依赖 flock 做原子读-改-写
- 别再用
flock()+file_get_contents()+file_put_contents()更新 JSON/配置类文件——这三步非原子,NFS 下极易出现 A 读旧值、B 写新值、A 覆盖 B 的脏写 - 改用追加写(
a模式)+ 单次原子操作:例如日志场景,直接fwrite($fp, $line . "\n")并确保flock($fp, LOCK_EX)后立即写入、立刻flock($fp, LOCK_UN),不中间rewind()或ftruncate() - 对需“读-改-写”的结构化数据(如 token、计数器),迁移到 Redis 或数据库:它们提供真正的原子命令(
INCR、GETSET、WATCH/MULTI),不受存储介质限制
若必须用 NFS 文件锁,强制启用 NFSv4 并验证锁行为
- 服务端确认开启 NFSv4:检查
/proc/fs/nfsd/versions是否含+4.0,禁用 v2/v3(echo "nfsd 1-3 n" > /proc/fs/nfsd/versions) - 客户端 mount 时指定:
mount -t nfs4 -o vers=4.0,hard,intr,noac,actimeo=0 server:/path /mnt/nfs;noac关闭属性缓存,actimeo=0强制每次访问都查服务端元数据 - PHP 中加锁后,用
lsof -n -P -w -T -a -p $PID | grep your_file查看锁是否真实挂载到 NFS 句柄,而非仅本地资源
兜底方案:用轻量级信号文件替代内容文件锁
当业务只需“防并发执行”而非“保护文件内容”,可用独立锁文件规避 NFS 语义缺陷:
- 创建专用锁文件(如
/mnt/nfs/.job_lock),用fopen(..., 'c')打开,flock($fp, LOCK_EX | LOCK_NB)尝试获取独占锁 - 成功则执行业务逻辑(此时可安全读写其他 NFS 文件),失败则重试或降级(最多 3 次,指数退避)
- 关键点:锁文件本身不存业务数据,只作同步信号;所有节点都操作同一个锁文件路径,不依赖其内容一致性
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











