使用map()处理对象数组时遇TypeScript错误2571：Object is of type 'unknown'

错误核心原因：TypeScript无法确定properties是否为数组类型——它的类型是单个对象、数组或undefined的联合类型，直接调用map会触发类型检查失败。以下是具体解决方案：

修正代码示例 #

const properties: { [x: string]: unknown; } | { [x: string]: unknown; }[] | undefined;

// 通过类型守卫缩小类型范围，仅当为数组时执行map
const myMap = Array.isArray(properties) 
  ? properties.map((item) => {
      // 断言item包含x和y属性（需确保API返回数据确实具备这些属性）
      const typedItem = item as { x: string; y: unknown };
      return { [typedItem.x]: typedItem.y };
    })
  : undefined;

关键细节说明 #

• 使用Array.isArray(properties)作为类型守卫，TypeScript会自动将properties的类型缩小为数组类型，此时调用map不再触发类型错误。
• 原代码中item的类型{ [x: string]: unknown;} | { [y: string]: unknown;}本质是同一类型（索引签名为string的对象），可简化为Record<string, unknown>。但由于要访问item.x和item.y，必须明确断言这些属性存在，否则TypeScript会提示属性不存在于索引签名类型中。
• 如果能确定API返回的数组元素固定包含x和y属性，建议直接优化类型定义，减少断言操作：

  // 更精确的类型定义
  type PropertyItem = { x: string; y: unknown };
  const properties: PropertyItem | PropertyItem[] | undefined;
  
  const myMap = Array.isArray(properties) 
    ? properties.map(item => ({ [item.x]: item.y }))
    : undefined;
  

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