Shopware 6中theme.json的configInheritance继承异常问题咨询

问题 #

我们在Shopware 6中使用theme.json内的configInheritance配置时遇到异常，具体情况如下：

• 主题继承链：aaaa → bbbb → cccc → dddd → eeee
• 初始状态：aaaa的base_config中mycustomvalue值为black，其余子主题config_values为NULL，均继承该值
• 异常现象：将cccc的mycustomvalue改为YELLOW后，dddd、eeee未按预期继承YELLOW，仍继承aaaa的black
• 排查结果：执行theme:refresh命令时，Shopware会更新theme表的parent_theme_id，但未遵循完整继承链，而是将configInheritance中除Storefront外的顶级父主题aaaa设为所有子主题的直接父级，导致继承链失效；此外Shopware仅读取直接父主题的base_config，无法读取祖父级主题配置，造成部分配置项缺失

现咨询：是否存在配置遗漏？有何解决办法？

解决办法 #

一、检查并修正theme.json的configInheritance配置 #

确保每个子主题的configInheritance仅指向直接父主题，严格遵循链式继承，禁止跳过中间层级直接指向顶级主题aaaa。示例配置：

• bbbb的theme.json：

{
  "name": "bbbb",
  "configInheritance": ["aaaa"]
}

• cccc的theme.json：

{
  "name": "cccc",
  "configInheritance": ["bbbb"]
}

• dddd、eeee的theme.json依次类推，分别指向各自的直接父主题。

二、手动修复数据库中主题的父级关联 #

登录数据库，修改theme表的parent_theme_id字段，确保每个主题的父ID指向其直接上一级主题：

• 将bbbb的parent_theme_id设为aaaa的ID
• 将cccc的parent_theme_id设为bbbb的ID
• 将dddd的parent_theme_id设为cccc的ID
• 将eeee的parent_theme_id设为dddd的ID

三、刷新主题并清除缓存 #

执行以下命令完成主题刷新与缓存清理：

bin/console theme:refresh
bin/console cache:clear
bin/console theme:compile

四、自定义扩展配置读取逻辑（可选） #

若上述方法仍未解决问题，可通过自定义插件扩展Shopware的主题配置读取逻辑，让系统递归读取完整继承链的base_config：

1. 创建自定义插件，监听ThemeCompilerPass或主题加载相关事件
2. 在事件处理方法中，递归遍历当前主题的完整父链，合并所有层级的base_config配置

关于配置遗漏的说明 #

大概率是theme.json中configInheritance的配置错误（跳过中间父级直接指向顶级主题），导致theme:refresh命令错误地将所有子主题的父级设为aaaa，破坏了正常的继承链。严格遵循链式继承的配置是解决问题的核心。

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