引入AsmFeatureModule后ASM功能模块未生效不显示顶部横幅问题求助

问题根因 #

该问题在Spartacus 4.0及以上版本中非常常见，核心原因是模块导入不全：
Spartacus从4.0版本开始将所有功能模块拆分为两层：负责核心业务逻辑的*-feature模块、负责根层级UI注册和全局配置的*-root模块。仅导入AsmFeatureModule的情况下，缺少ASM横幅组件的注册、LAUNCH_CALLER.ASM对应的启动映射配置，所以即使addUi方法触发了启动调用，也没有对应的组件可以渲染。
少数情况是因为ASM功能开关未显式开启、项目自定义配置覆盖了ASM的启动规则。

解决方案 #

• 补充导入AsmRootModule到根层级模块或SpartacusFeaturesModule中，注意AsmRootModule不能在惰性加载的子模块中导入：

import { AsmRootModule } from '@spartacus/asm/root';

@NgModule({
  declarations: [],
  imports: [
    AsmFeatureModule,
    AsmRootModule // 新增该导入
  ]
})
export class SpartacusFeaturesModule { }

• 确认全局配置中已显式开启ASM功能，避免默认配置未生效：

// app.module.ts 或全局配置文件中添加
provideConfig({
  features: {
    asm: true
  }
})

• 检查项目自定义配置，确认没有覆盖LAUNCH_CALLER.ASM对应的启动器配置，正常导入AsmRootModule会自动注册该配置，无需额外修改。
• 清理浏览器缓存并重新执行构建，访问页面时携带?asm=true参数即可看到ASM顶部横幅。

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