Magento 2.4.4升级后Page Builder Row组件无法使用求助

排查与修复步骤 #

• 确认组件文件存在性
  检查服务器上是否存在目标文件：pub/static/frontend/[你的主题标识]/[语言代码]/Magento_PageBuilder/js/content-type/row/preview.js。如果文件缺失，说明静态资源部署不完整，重新执行部署命令：

  bin/magento setup:static-content:deploy -f
  

  注意替换命令中的[你的主题标识]（如Magento/luma）和[语言代码]（如en_US）为实际项目值。

• 清理缓存与生成文件
  先清理系统缓存：

  bin/magento cache:clean
  bin/magento cache:flush
  

  再删除旧的静态资源与预生成文件：

  rm -rf pub/static/frontend var/view_preprocessed var/generation
  

  完成后重新部署静态资源。

• 验证Page Builder模块状态
  检查Magento_PageBuilder模块是否启用：

  bin/magento module:status Magento_PageBuilder
  

  若未启用，执行以下命令启用并升级数据库：

  bin/magento module:enable Magento_PageBuilder
  bin/magento setup:upgrade
  

• 检查自定义主题的组件配置
  如果使用了自定义主题，查看主题目录下的Magento_PageBuilder/content_types.xml文件，确认Row组件的preview路径配置未被错误修改，正确配置应包含：

  <contentType name="row" label="Row"
               preview_component="Magento_PageBuilder/js/content-type/row/preview"
               ...>
  </contentType>
  

• 查看浏览器控制台的详细错误
  打开浏览器开发者工具（F12）切换到Console标签，查看是否有更具体的错误信息（如404文件缺失、权限不足），根据提示针对性解决。

• 修复文件权限
  确保pub/static和var目录的文件权限正确：

  chmod -R 775 pub/static var
  chown -R [服务器用户]:[服务器用户组] pub/static var
  

  替换[服务器用户]和[服务器用户组]为实际运行Web服务的账号（如www-data:www-data）。

内容的提问来源于stack exchange，提问作者Harry Robinson