Magento 2中Page Builder渲染锁定问题的分析与解决方案

问题现象

在Magento 2.4.7-p2版本中，当管理员尝试在后台创建或编辑CMS区块时，系统会出现"Page Builder was rendering for 5 seconds without releasing locks"的错误提示。该问题表现为页面长时间卡在加载状态，无法正常保存内容，同时在浏览器控制台中会显示上述错误信息。

问题根源分析

经过技术分析，该问题主要由以下几个因素导致：

1. 跨域资源共享(CORS)限制：Page Builder在渲染过程中使用了iframe，而浏览器出于安全考虑实施了同源策略限制。

2. RequireJS配置问题：系统未能正确处理iframe内部的JavaScript模块加载，导致资源请求被阻止。

3. 渲染锁定机制：Page Builder的安全机制检测到渲染过程超过5秒未释放锁定，触发了错误提示。

解决方案

官方补丁方案

Adobe Commerce官方提供了ACSD-59582补丁来解决此问题，主要修改包括：

1. 引入了RequireJsConfigModifierInterface接口，允许动态修改RequireJS配置。

2. 创建了StageRenderFrameRequireJsConfigModifier类，专门处理Page Builder渲染框架的RequireJS配置。

3. 修改了pagebuilder_stage_render.xml布局文件，添加了配置修改器的引用。

4. 调整了render.phtml模板文件，移除了硬编码的RequireJS配置。

社区验证方案

社区开发者验证了以下两种解决方案：

方案一：修改iframe的sandbox属性

<iframe attr="id: 'render_frame_' + id" sandbox="allow-scripts allow-same-origin" style="position: absolute; width:0; height:0; border: none;"></iframe>

方案二：应用Composer兼容补丁

1. 下载并应用两个补丁文件：

   • fix-backend-error-page-builder-when-editing-cms-block.patch
   • fix-error-page-builder-when-editing-cms-block.patch

2. 执行完整的重新编译和部署：

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f

注意事项

1. 安全警告：直接修改iframe的sandbox属性添加allow-same-origin可能存在安全风险，建议优先采用官方补丁方案。

2. 浏览器兼容性：该问题在不同浏览器中表现可能不一致，建议在Chrome、Firefox等多个浏览器中测试。

3. 版本确认：确保使用的magento/module-page-builder模块版本为v2.2.5-p2。

4. 环境检查：如果使用内容分发网络服务，可能需要临时禁用以排除干扰。

后续建议

1. 定期检查Magento官方更新，获取最新的安全补丁和功能修复。

2. 在生产环境应用补丁前，先在开发或测试环境验证解决方案的有效性。

3. 考虑实施内容安全策略(CSP)配置，平衡功能需求与安全要求。

通过以上分析和解决方案，开发者应能有效解决Magento 2.4.7-p2中Page Builder的渲染锁定问题，确保后台内容编辑功能的正常使用。