如何在Symfony Bundle中添加Shopware 6后台配置？

1. 补充配置命名空间 #

Shopware的系统配置需要通过namespace属性关联到对应Bundle，你的config.xml缺少该属性，导致系统无法识别配置归属。修改配置文件，在<config>标签中添加命名空间（值为你的Bundle名称，比如MyBundle）：

<?xml version="1.0" encoding="UTF-8"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/shopware/platform/trunk/src/Core/System/SystemConfig/Schema/config.xsd"
        namespace="MyBundle"> <!-- 新增此行 -->
    <card>
        <title>Basic Configuration</title>
        <title lang="de-DE">Grundeinstellungen</title>
        <input-field>
            <name>email</name>
            <copyable>true</copyable>
            <label>eMail address</label>
            <label lang="de-DE">E-Mail Adresse</label>
            <placeholder>you@example.com</placeholder>
            <placeholder lang="de-DE">du@beispiel.de</placeholder>
            <helpText>Please fill in your personal eMail address</helpText>
            <helpText lang="de-DE">Bitte trage deine persönliche E-Mail Adresse ein</helpText>
        </input-field>
    </card>
</config>

2. 确认Bundle注册正确性 #

• 如果是Shopware插件形式的Bundle，检查composer.json中extra.shopware-plugin-class是否指向正确的Bundle类
• 确保Bundle类继承Shopware\Core\Framework\Plugin，而非普通Symfony Bundle

3. 非插件类Bundle需手动注册配置加载 #

若你的Bundle是独立Symfony Bundle（非Shopware插件），需在services.xml中手动注册系统配置加载器：

<service id="MyBundle.system_config_loader" class="Shopware\Core\System\SystemConfig\Loader\XmlFileLoader">
    <argument type="string">%kernel.project_dir%/path/to/MyBundle/Resources/config/config.xml</argument>
    <tag name="shopware.system_config_loader"/>
</service>

4. 执行完整的缓存清理与后台重建 #

运行以下命令确保所有缓存和构建文件更新：

# 清理缓存
bin/console cache:clear

# 编译主题、安装资源、重建后台
bin/console theme:compile
bin/console assets:install
bin/console administration:build

5. 检查后台用户权限 #

登录后台后，进入设置 > 用户与权限 > 角色，确认当前用户所属角色已开启「系统配置」的读写权限。

6. 查看日志定位错误 #

查看Shopware日志文件（var/log/prod.log或var/log/dev.log），搜索SystemConfig相关条目，排查是否存在XML格式错误或配置加载异常。

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