FengCMS · PHP+MySQL 升级实录 · 内容写入一致性:锁等待超时与跨模型子树删除竞态

关于 FengCMS :一个 2013 年开源的 PHP + MySQL 内容管理系统,曾被上万家网站使用,至今仍有网站在线运行;2026 年 10 月完成安全现代化升级,本文回顾的版本为 v1.37。开源仓库:github.com/fengcms/fengcms

各位看官,上一篇讲了竞态的通用排查法,这篇上两个真实解剖案例------编号 CM03 和 CM07,都出自内容写入这条业务线,也就是你每天在后台点得最多的那些按钮。

CM03 的症状很戏剧:批量回收 14 条内容,结果等了 60 秒,换来一个 504 网关错误页 ,哪条成功哪条失败一无所知。CM07 更隐蔽:删除一个父栏目的瞬间,另一条编辑请求正把内容挂到它的子栏目上------父删除成功、子栏目没了、那条保存还成功了,留下一个指向不存在栏目的脏引用。

一个是等待预算失控 ,一个是锁的管辖范围不够大。两个案子合起来,正好把"写入一致性"的两个半边讲全。这篇按完整闭环写:症状、时序复现、修复、独立复验数据。

本文要点

  • CM03:每项都等满 5 秒 × 14 条 = 超过网关时限 → 504,明细全丢
  • 修复:约 12 秒循环预算 + 单次等待取"5 秒与剩余预算的较小值",超预算回 unprocessed
  • CM07:关系锁只管本模型,跨模型子树删除从锁的缝隙里穿过
  • 修复:关系锁统一为跨模型 all-categories,递归按每个节点的实际模型处理
  • 验收铁律:同一失败时序重放、两种交错顺序都测、明细与数据库逐条对账

一、CM03:14 条记录吃掉 60 秒,然后 504

先看失败现场(复审报告的对照表原文):约 60.02 秒,HTTP 504 ,响应是网关错误页------changed、failed、unprocessed 全部"无法从响应得知"。而数据库里第一条已经回收了,其余没动。

也就是说:活干了一小半,结果一个字都没带回来。后台前端看到 504,不知道发生了什么;用户唯一理性的操作是再点一次------于是重试风暴来了,而系统此时还占着一堆锁。

病根在等待策略的算术上。原文两行:批量执行设置约 12 秒的循环预算 ,命名锁等待取单次 5 秒与剩余预算中的较小值 ------而"上次"的行为是:尚未开始处理的每一条,都老老实实等满完整的 5 秒 。14 条记录、13 条被别的连接持锁,逐条等下来 60 多秒,稳稳超过网关超时。更糟的是,预算耗尽后的失败连 JSON 都没写完就被网关掐了------明细和执行结果一起蒸发。

php 复制代码
// 旧等待策略(出问题的形状)
foreach ($ids as $id) {
    $wait = 5;                       // 每条都等满 5 秒,不管总共还有多少时间
    if (!acquire_named_lock($id, $wait)) { ... }
}
// 13 × 5s = 65s > 网关超时 → 504,已执行/未执行的明细全部丢失

// 修复后的预算制(示意)
$deadline = now() + 12;              // 循环总预算约 12 秒
foreach ($ids as $id) {
    $wait = min(5, $deadline - now());        // 单次等待 = min(5s, 剩余预算)
    if (now() >= $deadline) { $unprocessed[] = $id; continue; }  // 超预算:记账,不空等
    ...                                        // 开始执行的条目继续走完
}
return json(['changed'=>..., 'failed'=>..., 'unprocessed'=>..., 'already'=>..., 'missing'=>...]);

修复的精髓是把"没开始"和"开始了"分开对待 :预算到期后,尚未开始处理的 ID 直接返回 unprocessed,不再持续为后续每项等待完整的 5 秒 ;而已经开始执行的条目让它做完。响应结构变成 status=p 加五组 ID 明细 ------changed/failed/unprocessed/already/missing,每一条都有下落。

复验数据值得原样摆出来(同样的 14 条、13 条锁被占、真实 Nginx/PHP-FPM、不动服务器超时配置):

观察项 上次失败 本轮结果
HTTP 及耗时 约 60.02 秒,504 约 12.019 秒,200
响应结构 网关错误页 五组 ID 明细齐全
明细 全部无法得知 changed 1、failed 3、unprocessed 10
数据库状态 第一条已回收,其余未变 第一条为 -1,其余 13 条为 1,与明细相符

注意最后一行:响应说的和库里干的逐条对账相符 ------独立断言还核对了"五组数组的并集等于全部输入 ID,组间无重复,没有漏报或把未执行项标成完成"。这才是"成功"的定义:不是没报错,是账实相符 。随后释放 13 条锁重试:13 条进 changed 全部完成;再重试一次,14 条全进 already,没有再次改变数据------重试幂等也过了。

报告同时留了三句克制:12 秒不等于对任意 SQL 的硬中断保证 (部署仍要核对 PHP、网关时限);500 个 ID 的正式回归用例不能替代 这 14 条原场景重放;上表是本地同场景对照,不作为一般性能提速比例。

二、CM07:父删了,子没了,保存还"成功"

CM07 是典型的时序交错案,先看它的舞台------三级跨模型结构:A 模型父栏目 → B 模型子栏目 → A 模型孙栏目,再加一个外链子栏目(复验用真实后台接口建立,"没有用 SQL 强插不被后台接受的层级")。

失败时序是这样交错的:

text 复制代码
原失败时序(CM07)
T1  B 模型的内容起初未分类,拿到真实编辑签名
T2  独立连接锁住该内容行(SQL 行锁),提交"把内容归入 B 子栏目"的正常保存
T3  保存的 UPDATE 在数据库进程列表中等待 SQL 行锁...... 此时它持有旧的关系锁
T4  另一编辑处理 A 父栏目:删除成功(关系锁管辖不到跨模型的这段)
T5  释放 SQL 行锁 → 保存继续 → 成功引用了已不存在的 B 子栏目
结果:父删除成功、子栏目没了、内容挂在一个无效 ID 上 ------ 脏引用落库

病根一句话:关系锁的管辖范围和子树的实际形状不一致 。老实现里锁没有覆盖跨模型的整个关系网,而递归删除"把根模型用于整个子树"------可子树里每个节点各有各的模型(A 父、B 子、A 孙)。锁看着是锁住了,其实锁的是地图上的一小块,竞态从没画进地图的那块穿过去了。

修复也是两件套:

  • 关系锁作用域统一为跨模型的 all-categories ------内容保存、栏目单条/批量删除、清空、栏目创建全部用同一把关系锁 ;栏目新增和批量新增也在关系锁内执行,"减少子树检查与变更间的窗口"(上一篇的"焊缝"思路再次出现);
  • 递归处理按每个节点的实际 project 处理内容,不再把根模型套在整个子树上------锁和现实终于描述的是同一个结构。

子树删除为什么需要重新检查保存目标

栏目表单打开时,目标栏目存在;提交时,它可能已经被另一个管理员删除。页面中保存着合法的旧 ID,并不能证明提交时仍有合法目标。这个例子说明,表单阶段的校验只是方便用户操作,真正影响数据的一刻还要根据受保护的当前状态作判断。

同样,删除父栏目时需要确定删除范围。如果先计算子树,随后另一条请求改变了父子关系,旧范围就可能遗漏对象或处理不该处理的对象。阅读修复时,可以把"确定范围、校验关联、实施变更"连成一条线,检查它们是否受到一致的协调,而不是只在最后一条 DELETE 前加一个判断。

三、复验:两种交错顺序都要有明确结局

修复的验收设计得很硬:同一条失败时序原样重放 ,且对父栏目的单条删除、批量删除、清空三种操作各演一遍 ------结果全部 409,四个栏目及原有内容均保留,没有部分删除、没有部分清空 ;解除 SQL 行锁后,等待中的保存返回 200,引用仍存在的 B 子栏目;再执行父栏目操作才成功,"各模型内容及全部栏目删除"、外链栏目及 URL 不变。

光测"删除被挡住"还不够------竞态有两个方向 。于是补测反向交错:让删除先完成,再释放保存的记录锁------删除返回 200,旧编辑保存返回 400,内容仍为未分类,没有写入失效栏目 ID 。两种顺序都得到明确且一致 的结果:要么删不动,要么存不进,唯独没有"两边都成功"。

这正是写入一致性的完整定义:并发的两个操作,结局必须是以下之一------在该冲突用例中,一成功一拒绝或双双拒绝;若两个操作可按有效顺序串行完成,也可能都成功。关键是最终状态满足业务契约,不能各成功一半。 409 这个状态码在这里用得也讲究:它是"资源状态与你的请求冲突",前端拿到就知道该刷新重来,而不是当成 500 那样以为系统坏了。

配套的验收数字:./bin/dev check 343 个文件 0 语法错误;主回归 556 项通过 ;Node 支架跑 navigation.js 回调 288 项通过 (结果摘要必须含"尚未处理,请重试"和未处理 ID 数量------前端也得会说人话);独立原场景重放 50 项专项断言 ;Nginx 日志本轮窗口未出现 upstream 超时 ,原 14 条请求不再产生 504。至此 CM01 至 CM08 全部闭环。

诚实的尾巴照旧要有:PHP-FPM 日志仍有前台编译模板 strtotime(null) 的 2 条 Deprecated ------"不能称为日志无诊断";跨模型关系锁会串行化内容关系操作 ,本轮不据此作生产吞吐量或高并发延迟承诺;12 秒之外的网关、PHP 时限各站要自己核对。

"没有孤儿记录"之外,还应核对用户看到的结果

数据库层面的验收可以检查内容与栏目关联、被删子树是否还残留引用;界面层面则要检查返回消息是否准确。保存被拒绝时,应让操作者知道目标已经变化,而不是跳回列表后只显示通用成功提示。否则数据库虽然没有继续损坏,用户仍可能误以为刚才的内容已经保存。

两种交错顺序要分别记录:保存先取得有效执行条件,删除随后处理;删除先完成,旧保存随后到达。它们不必返回完全一样的响应,但最终状态必须能用操作顺序解释。再配一个不冲突的正常保存场景,才能确认修复没有把所有写入一并堵住。并发回归的价值,是给每一种允许发生的顺序规定结果。

小结

CM03 和 CM07 是写入一致性的两面:对内,等待要有预算 ------超预算宁可记账为 unprocessed 交出明细,也不空等成 504 把结果蒸发烧掉,"成功"的标准是响应与数据库逐条对账相符;对外,锁的边界必须等于业务的边界 ------子树跨模型,锁就得跨模型,递归就得按每个节点的真实身份处理。两者复验共享同一条铁律:原失败时序原样重放,两种交错顺序都要有唯一、明确、可对账的结局。

各位看官,你们的批量操作超时了,是返回明细还是甩一个 504?评论区对个暗号。

觉得在理就点赞收藏走一波,谢谢!

相关阅读:

本系列上一篇:PHP20《并发一致性与竞态治理》;下一篇:PHP22《数据库结构变更的失败续做》。

FengCMS 开源地址: https://github.com/fengcms/fengcms ------ 如果这个系列的文章对你有帮助,欢迎到仓库点个 Star;有想法也可以直接提 Issue 交流。

本文由 FungLeo 主导,Deepseek 优化校阅,转发请注明首发地址,谢谢大家!

相关推荐
ZhengEnCi1 小时前
覆盖索引是什么:用借书和外卖看懂回表这件事
sql·mysql·postgresql
鹤落晴春1 小时前
MySQL日志梳理
运维·数据库·mysql
冷豪1 小时前
协调:最后一道人工工序
工程实践·协作
谙弆悕博士2 小时前
多智能体架构详解:市场拍卖式架构(Market-based / 竞价协商)
开发语言·架构·去中心化·多智能体·智能体·拍卖架构
ShineWinsu2 小时前
对于Qt:QMessageBox的解析
开发语言·c++·qt·面试·客户端·qmessagebox·消息对话框
承渊政道2 小时前
【Python编程快速上手—让繁琐工作自动化】(列表:把数据排成队,从下标取值到深拷贝)
开发语言·python·pycharm·自动化·列表
FungLeo2 小时前
FengCMS · PHP+MySQL 升级实录 · MySQL DDL不能回滚:模型字段结构操作的失败续做
android·mysql·php·工程实践·fengcms
隔窗听雨眠3 小时前
MySQL锁等待的定位方法与治理体系
mysql·锁机制·数据库运维
tryCbest3 小时前
Python 爬虫从入门到实战(一):基础篇——从零写出第一个爬虫
开发语言·爬虫·python