Craft CMS 5.7.1.1中Matrix字段导致实时预览功能失效的解决方案

问题现象

在将Craft CMS从5.6.17版本升级到5.7.1.1后，用户发现使用Matrix字段（作为富文本编辑器形式）的条目编辑页面出现了JavaScript控制台错误："Uncaught No disclosure container found"。这导致实时预览按钮点击无效，无法正常加载预览界面。

值得注意的是，这个问题仅出现在已存在的条目编辑页面。新建条目时不会出现此错误，实时预览功能可以正常工作。但一旦保存条目后，错误就会重现。

问题原因

此问题与Craft CMS 5.7版本中JavaScript依赖项的更新有关。在5.7版本中，系统更新了大量的前端依赖库，包括jQuery等核心组件。当升级后，旧的CP资源文件可能被浏览器或服务器缓存，导致新旧版本的JavaScript代码不兼容。

特别是Matrix字段由于其复杂的交互逻辑，对JavaScript依赖更为敏感。当缓存的旧资源与新版本的核心代码混合使用时，就会出现"disclosure container"相关的错误，进而影响实时预览功能的正常工作。

解决方案

1. 重建项目配置
   在终端运行以下命令可以重建项目配置：

   ./craft project-config/rebuild
   

2. 清除缓存
   完成项目配置重建后，需要清除所有缓存：

   • 清除Craft系统缓存
   • 清除站点缓存
   • 清除浏览器缓存

3. 强制刷新前端资源
   在浏览器中按Ctrl+F5(Windows/Linux)或Cmd+Shift+R(Mac)强制刷新页面，确保加载最新的前端资源。

预防措施

为了避免类似问题在未来升级时再次发生，建议：

1. 在升级CMS版本前，先清除所有缓存
2. 升级完成后立即重建项目配置
3. 使用无痕/隐私浏览窗口测试新版本功能
4. 考虑在升级过程中暂时关闭CDN缓存

技术背景

Craft CMS的实时预览功能依赖于前端JavaScript与后端API的协同工作。Matrix字段作为一种复杂的内容构建工具，其交互逻辑需要特定的DOM容器结构。当JavaScript版本不匹配时，可能导致框架无法正确找到所需的DOM元素，从而抛出"disclosure container"错误。

这种类型的问题在大型前端框架升级时较为常见，特别是在有缓存机制介入的情况下。理解这一点有助于开发人员在遇到类似问题时快速定位原因并采取有效措施。