基于release/5.0.0-CF1 Spartacus复制模块触发TS2532错误

问题场景 #

• 基于release/5.0.0-CF1版本的Spartacus库生成新项目
• 从同版本官方源码中复制order-history模块到新项目，并在spartacus-features.module.ts中完成模块引入
• 运行项目后，order-history.component.html文件触发TS2532: Object is possibly 'undefined'类型错误
• 项目package.json的依赖版本与release/5.0.0-CF1完全匹配，且官方源码未禁用strictNullChecks配置却能正常编译，而禁用当前项目的该配置后错误即可消失

原因分析 #

官方Spartacus源码在构建流程中，可能通过补充类型声明、使用特定构建插件等方式，提前处理了严格空检查下的潜在类型问题。而新项目默认的TypeScript配置未包含这些额外处理逻辑，直接复制模块后，未处理的空值引用就会触发类型检查错误。

解决方案 #

方案1：临时规避（快速解决）

在项目根目录的tsconfig.json中，修改strictNullChecks配置为false：

{
  "compilerOptions": {
    // 其他配置...
    "strictNullChecks": false
  }
}

保存配置后重新编译项目，错误即可消除。

方案2：规范修复（保留类型安全）

针对order-history.component.html中报错的对象，添加空值防护：

• 使用可选链操作符：将{{ order.propertyName }}修改为{{ order?.propertyName }}
• 使用*ngIf提前判断对象存在：

<div *ngIf="order">
  {{ order.propertyName }}
</div>

这种方式既能保留严格空检查的类型安全优势，又能从根源上解决空引用问题。

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