Shopware6应用更新时，如何移除残留的Configure菜单项？

以下是几个可行的方案，帮你在不卸载包的前提下清理旧的配置菜单项：

1. 用包迁移脚本主动清理旧配置 #

Meteor允许在包中添加服务器端启动脚本，用来处理版本更新时的迁移逻辑。你可以借助Meteor Admin SDK的API，直接移除旧config.xml对应的配置scope：

首先在package.js中添加迁移文件的引用：

Package.onUse(function(api) {
  api.versionsFrom('2.9.0');
  // 其他包配置...

  // 添加迁移脚本，仅在服务器端运行
  api.addFiles('server/clean-old-config.js', 'server');
});

然后创建server/clean-old-config.js，写入清理逻辑：

import { Admin } from 'meteor/meteor-admin-sdk';
import { Meteor } from 'meteor/meteor';

Meteor.startup(() => {
  // 替换成你旧config.xml里的scope名称
  const oldScopeName = 'your-old-config-scope';
  
  // 检查旧scope是否存在，存在则移除
  if (Admin.configScopeExists?.(oldScopeName)) {
    Admin.removeConfigScope(oldScopeName);
  }
});

注：configScopeExists和removeConfigScope是Meteor Admin SDK常见的API，如果你的版本有差异，可查对应版本的SDK文档调整方法名。

2. 在manifest.xml中显式废弃旧scope #

如果你的Meteor Admin SDK版本支持，可以在新的manifest.xml里直接标记旧scope为需要移除：

<admin-config>
  <!-- 你的新配置项 -->
  <scope name="new-config-scope" label="新配置">
    <!-- 新配置内容 -->
  </scope>
  
  <!-- 显式移除旧配置scope -->
  <scope name="your-old-config-scope" remove="true" />
</admin-config>

这个方式依赖SDK的manifest解析逻辑，若官方文档未提及该语法，优先用脚本方案。

3. 直接清理数据库中的旧配置记录 #

如果前两种方法无效，可以直接操作MongoDB删除旧的配置注册条目。Meteor Admin SDK通常会把配置存在adminScopes集合中：

# 在MongoDB shell中执行
db.adminScopes.remove({ name: 'your-old-config-scope' });

你也可以把这个操作封装到服务器端脚本里，让包更新时自动执行，同时记得加一个执行标记（比如用migrations集合记录），避免重复清理。

注意事项 #

• 测试时一定要模拟真实的更新流程：从旧版本包升级到新版本，验证旧菜单项是否消失，新配置是否正常加载。
• 若SDK没有现成的移除API，可以直接操作对应的数据库集合，这是最直接的兜底方案。

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