如何使用TypeScript修复解构undefined或null值的报错问题？

TypeError: Cannot destructure property 'objectProperties' of '(intermediate value)...' as it is undefined.

这个报错的本质是：当 registryReportSettings?.extended 取值为 undefined 或 null 时，你尝试对空值进行解构操作，JS原生不支持对null/undefined解构，就会抛出运行时错误。
另外你的类型定义存在不准确的问题：你现在给 registryReportSettings 的 extended 字段标注的类型是ReportPropertiesRequest，但实际服务端返回可能存在extended为null/undefined的情况，TS类型和实际运行值不匹配，导致TS没有提前捕获到这个风险。

方案1：解构时添加空值兜底（最简便） #

使用**空值合并运算符??**给extended的空情况兜底一个空对象，空对象解构不会报错，如果需要还可以给每个解构属性设置默认值：

this.getRegistrySettings(registry.Id).subscribe((registryReportSettings: { extended?: ReportPropertiesRequest | null }) => {
  // 先修正extended的类型，标注为可选+可能为null，匹配实际返回
  const { 
    objectProperties = [], 
    reportProperties = {}, 
    textProperties = '' 
  } = registryReportSettings?.extended ?? {};
  // 后续业务逻辑
})

?? 只会在左侧值为undefined/null时触发兜底，不会覆盖0、false等合法假值，比||更适合这个场景。

方案2：提前做空值判断，类型窄化后再解构 #

如果空值属于异常情况，你可以先判断拦截空场景，TS会自动识别到后续代码中extended一定是有效值，不会提示类型问题：

this.getRegistrySettings(registry.Id).subscribe((registryReportSettings: { extended?: ReportPropertiesRequest | null }) => {
  const extended = registryReportSettings?.extended;
  // 空值提前处理返回
  if (!extended) {
    console.warn('未获取到报表配置，跳过后续逻辑');
    return;
  }
  // 此时TS已经确认extended是非空的ReportPropertiesRequest类型，解构不会报错
  const { objectProperties, reportProperties, textProperties } = extended;
  // 后续业务逻辑
})

方案3：添加运行时类型校验（适合对数据准确性要求高的场景） #

如果按业务逻辑extended字段不应该为空，你可以添加自定义类型守卫，做运行时校验，既避免类型报错，也能提前拦截非法的接口返回：

// 自定义类型守卫，判断值是不是合法的ReportPropertiesRequest
function isReportPropertiesRequest(val: unknown): val is ReportPropertiesRequest {
  return !!val && typeof val === 'object' 
    && 'objectProperties' in val 
    && 'reportProperties' in val 
    && 'textProperties' in val;
}

this.getRegistrySettings(registry.Id).subscribe((registryReportSettings: unknown) => {
  const extended = (registryReportSettings as any)?.extended;
  if (!isReportPropertiesRequest(extended)) {
    // 非法返回的异常处理逻辑
    throw new Error('接口返回的报表配置格式错误');
  }
  const { objectProperties, reportProperties, textProperties } = extended;
  // 后续业务逻辑
})

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