Spartacus 5.2 OOTB翻译环境不一致问题求助

我们的Web应用使用Spartacus自带（OOTB）翻译，但开发、预发布（staging）环境和生产（prod）环境显示不一致——开发和预发布环境显示字面量[addressCard:addressCard.shipTo]，而非预期的“Ship To”标签，生产环境则正常显示。已确认Angular应用代码中未覆盖该翻译值，刚加入团队不熟悉Spartacus，求排查方向。

示例代码：

getShippingAddressCard(deliveryAddress: Address, countryName?: string): Observable<Card> {
return combineLatest([
      this.translation.translate('addressCard.shipTo'),
    ]).pipe(
      map(([textTitle]) => {
          return {
          title: textTitle,
          textBold: deliveryAddress.firstName + ' ' + deliveryAddress.lastName,
          text: [
            deliveryAddress.line1,
            deliveryAddress.line2,
            deliveryAddress.town + ', ' + region + countryName,
            deliveryAddress.postalCode,
            this.maskService.applyMask(deliveryAddress.phone, '(000) 000-0000'),
            userEmail
          ],
        };
      })
    );
}

排查方向 #

• 检查翻译文件加载状态：在开发/预发布环境的浏览器控制台查看网络请求，确认Spartacus的OOTB翻译JSON文件是否成功加载，且文件内包含addressCard.shipTo对应的键值对。
• 对比环境配置差异：查看environment.ts和environment.prod.ts中的i18n配置，重点检查backend.loadPath是否指向正确的翻译资源地址，是否存在调试模式开关导致翻译未正常生效。
• 确认Spartacus版本一致性：验证三个环境使用的Spartacus版本是否完全一致，不同版本的OOTB翻译键可能存在变更，部分旧版本可能存在翻译加载的已知bug。
• 排查翻译加载时机：开发环境可能存在异步加载顺序问题，组件渲染时翻译资源尚未加载完成，导致显示占位符。可检查TranslationModule配置是否开启翻译预加载，或在组件中添加翻译就绪的判断逻辑。
• 清除环境缓存：预发布环境可能缓存了旧的翻译资源，尝试清除浏览器缓存或触发服务器缓存刷新，确认是否为缓存导致未获取最新翻译内容。
• 检查语言环境设置：确认开发/预发布环境的默认语言是否与生产环境一致，若开发环境误配置为未加载翻译包的语言，会回退显示翻译键名。

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