Shopware 6应用Admin模块未在后台菜单显示的排查咨询

• 权限配置不足
  当前manifest仅声明了<read>product</read>权限，但Shopware后台菜单的显示需要用户具备访问该App模块的权限。需添加App相关权限，比如在<permissions>节点中加入：

  <read>app</read>
  

  同时要检查后台用户的角色配置，确保该角色已被授予对应App模块的访问权限（在后台“Settings > Users & Permissions > Roles”中找到对应角色，在“Apps”标签下勾选你的VisualSearch应用权限）。

• 父菜单节点验证
  确认parent="sw-extension"的正确性：Shopware 6默认的扩展菜单父节点为sw-extension，但部分版本或自定义环境中可能存在差异。可以通过开启开发者模式后，在菜单上右键“Inspect”查看目标父菜单的实际节点名称，避免拼写或节点名称错误。

• 模块源地址的可访问性与合法性
  尽管你确认源地址有效，仍需检查：

  • Shopware服务器能否正常访问http://myapp/admin/shopware（比如容器化环境中，localhost指向容器内部而非宿主，需改用宿主IP或域名）；
  • 该地址返回的内容需符合Shopware Admin iframe模块要求，确保页面包含必要的Shopware App SDK初始化代码，且无跨域拦截问题（可在浏览器控制台查看是否有跨域错误）。

• 缓存未清除
  Shopware会缓存菜单结构，需手动清除后台缓存：

  1. 进入后台“Settings > System > Cache”，点击“Clear cache”；
  2. 或执行命令行：bin/console cache:clear；
  3. 最后强制刷新后台页面（Ctrl+F5）。

• 模块名称冲突
  name="VisualSearchAdminModule"可能与其他已安装的App/插件模块名称重复，导致菜单被覆盖。尝试修改为唯一名称，比如VisualSearchAdminPanel，重新安装激活应用。

• Manifest Schema版本不匹配
  当前使用的manifest-1.0.xsd可能与你的Shopware版本不兼容。检查Shopware版本对应的Manifest Schema版本：

  • Shopware 6.3及以下：使用1.0版本；
  • Shopware 6.4+：可升级为2.0版本（修改xsi:noNamespaceSchemaLocation为对应的2.0版本Schema地址）。

• 应用激活流程异常
  再次确认应用在后台“Extensions > My extensions”中处于激活状态，无报错提示。同时检查app-activated webhook是否正常触发，确保应用激活流程完全完成（可查看你的App服务器日志确认webhook请求是否收到）。

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