业务专题

页面装修的草稿发布与回滚

装修模板为什么必须有三段语义、组件白名单解决什么问题、发布与回滚在数据层是怎么落地的。

最后更新:2026/11/19

一、为什么需要三段语义

页面改版有两个诉求互相冲突:

  • 运营希望随时改,活动节点前改完就上线
  • 技术希望改坏能退,出问题不用手工复原

只做「保存即生效」,运营的每次试错都直接落到线上;只做「改完发版」,运营就被研发排期拖住。

草稿 / 发布 / 回滚三段分别解决:试错不落线上、确认后才生效、出错能退回。

二、数据层怎么落地

装修模板以 JSON 存储,一条模板有三类数据:

数据说明是否会生效
草稿态运营正在编辑的内容否
发布态当前线上生效的内容是
历史版本每次发布生成一份快照否,可回滚

关键点:草稿与发布是两份独立数据,不是同一份数据的两个标记位。如果用标记位,发布时就要原地改数据,一旦改坏,回滚只能靠另外的备份。

三、组件白名单

白名单限制「可被拖入页面的组件集合」。它解决的不是安全问题,是可维护性问题:

  • 没有白名单,运营可能拼出 20 种变体的轮播,每种都要单独适配
  • 有白名单,可用区块收敛在固定集合内,样式与响应式只需覆盖这些

白名单在代码里是可配置的列表,新增一个组件意味着要同步做样式、响应式与深色模式适配,因此增组件要走评审而不是随手加。

四、发布流程

  1. 运营在后台编辑草稿
  2. 预览(看到的是草稿态,不影响线上)
  3. 确认发布 → 当前发布态存入历史快照,草稿态成为新的发布态
  4. 发布动作记入操作日志(谁、什么时候、发布了哪张模板)

五、回滚流程

  1. 在历史版本里选一份
  2. 回滚 → 该版本成为新的发布态
  3. 注意:回滚不会删除当前版本,当前版本会先进历史快照,所以「回滚的回滚」是可能的

六、几个容易做错的点

发布不能跳过校验。模板 JSON 结构错误时发布成功但页面崩,这类问题要在发布前校验,而不是靠运营肉眼检查。

回滚粒度是整张模板,不是单个区块。想只改一个区块,应该走草稿 + 发布,而不是回滚。

素材要一起管。模板引用的图片素材如果被删除,模板就会渲染失败。素材必须有引用计数,被引用的素材不允许直接删。

七、验收问句

上线前用这四个问题自查:

  1. 改坏了能不能一键退回上一版?
  2. 预览看到的和发布后看到的是不是同一份数据?
  3. 运营能拼出的区块是否都在白名单内?
  4. 模板引用的素材有没有删除保护?

需要针对你的场景给建议?

不用先看完全部文档。说清产品线与当前进度,我们直接给判断。