为何encumbranceByType对象会出现TS可能未定义报错？

API 探路者

2026-8-3

解决TypeScript“对象可能未定义”报错问题

报错原因

TypeScript的静态类型分析无法追踪forEach循环中对encumbrancesByType对象的动态赋值逻辑。尽管你的代码在运行时确保了每个type对应的数组都会被初始化，但TS无法识别这种运行时的条件判断，仍然会认为encumbrancesByType[e.type]可能为undefined。

解决方案

1. 使用类型断言显式声明

直接告诉TypeScript当前属性必然存在，适合你确认逻辑无漏洞的场景：

encumbranceData.forEach((e) => {
  if (!encumbrancesByType[e.type]) {
    encumbrancesByType[e.type] = [e.suite];
  } else {
    (encumbrancesByType[e.type] as string[]).push(e.suite);
  }
});

2. 改用`Map`替代普通对象

Map的类型推断更清晰，能避免对象索引的类型歧义：

const encumbrancesByType = new Map<string, string[]>();
encumbranceData.forEach((e) => {
  const suites = encumbrancesByType.get(e.type);
  if (suites) {
    suites.push(e.suite);
  } else {
    encumbrancesByType.set(e.type, [e.suite]);
  }
});

// 渲染时转换为键值对数组
const encumbrancesContent = Array.from(encumbrancesByType.entries()).map(([type, suites]) => (
  <EncumbranceAlertByType key={type} id={type} suites={suites} type={type} />
));

注意：原代码中EncumbranceAlertByType组件要求必填id属性，渲染时需补充传入。

3. 用`reduce`重构数据处理逻辑

reduce的返回类型可以通过泛型明确指定，TypeScript能更好地跟踪累加器的状态：

const encumbrancesByType = encumbranceData.reduce<EncumbrancesByType>((acc, e) => {
  // 先初始化空数组，避免后续push时报错
  acc[e.type] = acc[e.type] || [];
  acc[e.type].push(e.suite);
  return acc;
}, {});