FengCMS · PHP+MySQL 升级实录 · MySQL DDL不能回滚:模型字段结构操作的失败续做

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

各位看官,第 3 批《数据与可靠性》到这里收官。前几篇反复出现一句话:"MySQL DDL 不能靠事务回滚。"这篇把它拆开讲透------因为整个模型结构模块(MS01~MS06)的设计,就是围着这一条不可动摇的事实建起来的。

DML(INSERT、UPDATE)失败可以 ROLLBACK,一切复原;DDL(CREATE TABLE、ALTER TABLE、DROP TABLE)隐式提交 ------DROP 落下去,表没了就是没了,事务日志救不回来。所以面对 DDL,成熟的系统不追求"回滚"这个不存在的东西,而是追求另外四个字:失败续做------半路失败不怕,留下恢复日志,按原身份把没做完的做完。

这篇讲三件事:为什么"回滚"在这里是幻觉、恢复日志怎么把断点记成可续做的账、以及"部分删除后排队写入"这个经典连环坑怎么堵。

本文要点

  • DDL 隐式提交:DROP 之后没有 ROLLBACK,恢复日志 ≠ 数据快照
  • model_schema_operation:模型 ID、字段 ID、物理列、阶段------断点的四要素
  • 锁后统一校验:把"缺表异常"提前变成"409 拒绝"
  • 验收:受控故障注入 + 三组引擎组合重放 + 幂等重试

一、承认现实:回滚不存在,所以别设计依赖回滚的流程

修复方案文档里有一句放在"数据库升级"一节的定性原话:

MySQL DDL 已生效后无法靠事务还原字段值或已删除的表;恢复日志负责识别阶段与安全续做,不等于数据快照。

这句话分两半,每一半都在纠正一种想当然:

前半句纠正"事务万能论"。 PHP 里包一层 beginTransaction() 就以为 DROP TABLE 失败能退回去------退不了。DDL 一执行就隐式提交,表没了、列值没了,ROLLBACK 滚的是 DML 的账,管不着 DDL 的现场。老代码里但凡有"先删了再说,不行就回滚"的结构,都是在赌一个不存在的保险。

后半句纠正"日志万能论"。 恢复日志记的是进度 (做到哪一步了),不是数据 (删掉的东西还在不在)。文档把边界说得不能再直白:字段与模型删除若已完成物理 DROP,恢复流程只续做配置及状态清理,不承诺恢复原数据 。日志能保证的是"账不乱、活能干完",不能让被删的表起死回生------想要数据后悔药,只有事前的备份(第 16 篇的那套)。

承认这两条,设计就从"如何回滚"转向"如何让失败可续做、可重试、可对账"。

二、恢复日志:把断点记成四要素的账

承接这个哲学,新增了一张表 model_schema_operation(tools/migrate.php 新增幂等的 migrate_model_schema(),新安装 SQL 同步创建;部署代码前先运行迁移 ,且该表强制 InnoDB,哪怕历史模型元数据还是 MyISAM)。

每条恢复日志记四样东西:原模型 ID、字段 ID(或名称)、物理列名、操作阶段 。四个要素回答了续做的全部前置问题:哪张桌子上的哪个抽屉、进行到哪一步。有了它,一次结构操作的生命周期长这样:

text 复制代码
模型删除的阶段账(示意)
登记阶段 → 记录 模型ID + 操作阶段(先记账,再动手)
  ↓ 执行:清栏目引用检查 → DROP 内容表 → 清字段配置 → 清状态 → 删模型行
  ↓ 任何一步失败 → 停在原地,阶段留在日志里,响应 409
续做:用【原模型 ID】重试删除 → 核对阶段 → 只补做没完成的步骤
  ↓ 全部完成 → 日志清除,各表状态对账为零
护栏:待恢复日志存在期间,禁止同项目代号被重新创建或导入(防止新旧身份串台)

几个设计点值得单独夸:

其一,先记账再动手。 允许删除时"先记录模型 ID 和操作阶段,再删表"------顺序反过来就完了:先删表后记账,记账那步挂了,现场就成了无名尸。

其二,身份防复用。 "待恢复日志阻止同项目代号被重新创建或导入",且"重建同名项目后,旧模型 ID 的删除请求不会作用于新模型 "------项目代号删了可以再建,但如果旧的续做请求还揣着老 ID,绝不能让它落到新建的同名模型头上。续做的锚点是不可复用的 ID,不是可复用的名字。

其三,该拒绝时拒绝,不硬续。 字段删除(MS01/MS02)的续做规则:"若待恢复建列的定义已改变,或已完成删列后同名列再次出现,拒绝自动处理并要求人工核对 ";系统字段批量(MS03)"已有物理列且没有本系统恢复日志时拒绝覆盖 "。自动续做只在世界没变的前提下执行------世界变了就交给人,因为 DDL 不可逆,猜错一次就是永久损失。

其四,删字段的响应要说实话。 "删除字段的物理值一旦 DROP 即不可撤销,失败响应明确指出物理列是否已经删除"------不装作还能救,把真实阶段告诉操作者,让他知道该去找备份还是该重试。

恢复记录应当描述事实,而不是只写意图

在执行结构变更之前写"准备删除",与确认完成后写"已经删除",含义完全不同。进程可能恰好停在两者之间,因此恢复程序不能只看到一条开始记录,就推断后续动作全部完成。它需要结合记录与数据库现状,确认哪个阶段已经生效、哪些对象仍然存在。

这也是恢复信息必须可定位的原因。接手者应能把一条记录对应到本次操作及受影响对象,避免把旧失败的记录误认为当前任务。对于无法自动判断的状态,保留现场并给出可核查的说明,比盲目重试更可靠。失败续做解决的是"从已发生的事实继续",不是把整个过程假装成从未开始。

三、连环坑:表已 DROP,排队的保存还在等锁

MS06 是这批里最漂亮的案子,一个两阶段事故。

背景:模型创建、修改、导入、删除、字段修改、内容写入全部在同一把 MySQL 命名锁内完成 (按数据库和项目代号,与模型导入同一把)。锁保证了互斥------但互斥只能保证顺序 ,保证不了顺序里的每一步都检查了环境。

失败时序(复审报告与修复记录的对照):

text 复制代码
MS06 原失败时序
T1  会话 A 删除模型:取得模型锁 → DROP 内容表 → 清理字段与内容状态
    → 在删除模型行时遇到故障 → 返回 409、释放锁
    此刻:模型状态 -2(部分删除),内容表已经没了
T2  会话 B 的旧编辑保存一直在锁上排队 → 终于拿到锁
T3  B 直接读物理字段 → 表不存在 → HTTP 500 缺表异常
问题:删除失败留在"部分完成"状态,排队写入拿到锁后对环境一无所知

注意这和第 20、21 篇是同一个家族:检查与使用之间有条缝 ------只不过这次缝里发生的事是"删除把世界改了一半"。而最开始的失败本身也是 DDL 不可回滚的直接后果:表删了,模型行没删掉,系统停在半空。

修复分两层:

第一层:把检查挪到锁后、读结构前。 统一锁后校验在取得模型锁后重新读取模型 ID 和状态 ,检查原身份是否匹配,以及负状态、待恢复操作、物理表缺失 等情况,用明确的 409 拒绝继续处理 。落点精确到行号:单条保存的校验位置早于物理字段读取 ,批量新增的校验早于批量内容解析及写入 ,直接内容写入同样调用------并且"不是依赖最终捕获数据库缺表异常 "。一字之差是境界的差别:把 500 变成 409,就是把"系统坏了"变成"状态不对,请重试"。

第二层:让失败的删除可续做。 复验里移除故障后"用原模型 ID 重试删除,返回 200 ,模型、字段、两类内容状态及结构日志均清理完成"------半路死掉的删除,接着上次的阶段把剩下的步骤干完;再次提交旧内容表单返回 404,没有重建内容表。

验收是故障注入 + 多组合重放。 复验仅在隔离库设置测试触发器------"在写入模型删除日志前暂停删除,在删除模型配置行时注入 SQL 异常",用来固定与上次相同的请求顺序及故障位置 ,并明确"不属于产品改动"。时序复验有一步格外讲究:确认排队请求已通过入口、在实际 GET_LOCK 上等待同一个模型锁,才解除暂停 ------"避免把入口拒绝误当作锁后校验通过",即必须让对手真的排进队里拿到锁 ,测试才有意义。最终三组引擎组合(InnoDB/InnoDB、MyISAM/InnoDB、MyISAM/MyISAM 元数据与内容表)重放:删除失败 409、排队旧保存 409、原 ID 重试 200 ,共 34 项断言;隔离 HTTP 日志500 为 0、缺表错误消息为 0 ;主回归 587 项通过 ,345 个文件 0 语法错误。至此模型结构专项 MS01~MS06 全部闭环。

运维边界照例写清:不得直接清空恢复日志表后重用项目代号 ;栏目仍引用模型时先处理引用再重试删除;大表 DDL 的停写时间需在站点副本测量;生产大表、磁盘耗尽、进程强杀不在本轮验证范围------DDL 慢起来是分钟级的,这个数字各站自己测。

重复执行是否安全,要逐步证明

幂等不能只靠函数名字或一个完成标记来保证。例如对象已经不存在时,后续清理是否仍能正确执行;对象存在但属性已变化时,是否需要停下来;上一步完成、下一步未完成时,是否能准确继续。每一个判断都要对应实际状态,而不是所有异常统一忽略。

排队的写请求尤其值得单独验证:它等待锁期间,所依赖的模型或表可能已经变化。拿到锁以后重新检查前提,才能避免沿着等待之前的判断继续执行。把这些场景纳入恢复演练,才算同时照顾了执行结构变更的人与当时仍在操作后台的人。DDL 的限制不会消失,但失败状态可以变得可识别、可交接。

小结

"MySQL DDL 不能回滚"逼出了这套设计的全部形状:不赌回滚,赌续做 ------先记账再动手、阶段四要素、身份用不可复用的 ID 锚定、世界变了就拒绝自动续做;锁后统一校验把缺表 500 提前变成状态 409;故障注入固定时序、三组引擎组合重放、幂等重试对账收尾。DDL 的不可逆不是系统的缺陷,是数据库的物理定律------好的设计不和定律较劲,只和自己的流程较劲。

各位看官,你们被不可回滚的 DDL 教育过吗?丢过表的来举个手。

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

相关阅读:

本系列上一篇:PHP21《内容写入与子树删除一致性》;下一篇:PHP23《后台双角色与权限矩阵》。

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

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

相关推荐
隔窗听雨眠28 分钟前
MySQL锁等待的定位方法与治理体系
mysql·锁机制·数据库运维
雨白1 小时前
Android 建造者模式实战:从 AlertDialog 源码到 TopBar 的两种实现
android
_祝你今天愉快4 小时前
Android 高级绘制:[五] 贝塞尔曲线与计算规则
android
千寻技术帮5 小时前
基于Spring Boot+Vue的农产品销售管理系统(源码+文档+数据库,附部署教程)
java·数据库·spring boot·后端·mysql·vue
Star(up up up)6 小时前
MySQL 事务隔离级别是如何实现的?从 MVCC 到锁机制原理详解
笔记·vscode·sql·学习·程序人生·mysql·学习方法
Decay__15 小时前
PostgreSQL 数据库全栈运维实战系列 — 合集索引(24 篇)
运维·数据库·sql·mysql·架构
田超凡16 小时前
深入理解MySQL_经典问题总结2
mysql·java-ee
FungLeo18 小时前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
yz_aiks18 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux