Shopware 6自定义CMS块未注册：缺失项排查与调试方法咨询

一、扩展可能缺失的内容 #

• 检查src/Resources/app/administration/src/module/sw-cms/blocks目录结构，确保自定义块的组件目录（如my-custom-block）及index.js文件存在，且文件内正确导出块配置
• 确认src/Resources/app/administration/src/main.js中已引入自定义块的注册代码，例如：import './module/sw-cms/blocks/my-custom-block'
• 验证插件主类的build方法是否正确注册前端资源，示例代码：

  public function build(ContainerBuilder $container): void
  {
      parent::build($container);
      $container->setParameter('your-plugin-name.admin.build', true);
  }
  

• 检查自定义块的index.js，确认已通过Shopware.Service('cmsService').registerCmsBlock()完成注册，且name、category等参数符合规范（category需对应后台现有分类，如text、text-image）
• 确认插件已完成激活：执行ddev exec ./bin/console plugin:install --activate YourPluginName，仅安装未激活会导致前端资源不加载

二、正确的调试步骤 #

• 实时构建日志排查：执行ddev exec ./bin/build-administration.sh --watch，查看构建过程是否有语法错误、文件缺失等报错，确认前端资源是否正常打包
• 浏览器控制台检查：打开后台「购物体验」页面，按F12打开开发者工具，查看Console标签是否有JS报错（如组件未找到、注册方法调用失败）
• 插件状态验证：执行ddev exec ./bin/console plugin:list，确认插件状态为Active，若为Installed需执行激活命令
• 清理缓存：执行ddev exec ./bin/console cache:clear，同时按Ctrl+Shift+R强制刷新浏览器，避免旧资源缓存干扰
• 代码逐行对比：将你的代码与官方指南示例逐行比对，重点检查块注册参数、文件路径、引入语句是否完全匹配
• 数据库验证：执行ddev exec ./bin/console dbal:run-sql "SELECT * FROM cms_block WHERE name = 'your-block-name'"，替换为你的块名称，确认块数据已写入数据库

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