使用unknown类型时，in操作符检查属性仍触发@typescript-eslint不安全赋值错误

你遇到的核心问题是：TypeScript的类型收窄需要精确到嵌套结构的每个层级，而你之前的校验逻辑没有覆盖到数组元素（data.errors[0]）的具体结构，导致TypeScript无法确认data.errors[0].detail的类型，进而触发@typescript-eslint的安全规则报错。

具体原因 #

即使你检查了data是对象、包含errors属性，且errors是数组，但TypeScript默认不会自动推断数组元素的类型，data.errors[0]仍然是unknown类型。直接访问它的detail属性，ESLint会判定为“不安全的成员访问”；解构赋值时也会因为无法确认类型，报“不安全的any赋值”。

解决方法：用精确的运行时校验收窄类型 #

你需要通过多层条件判断或自定义类型守卫函数，逐步确认每个嵌套层级的结构，让TypeScript明确知道每个变量的类型，ESLint也会认可这些操作的安全性。

方法1：多层条件判断（直接在函数内实现）

function handleResponseErrors(data: unknown) {
  // 第一层：确认data是非null对象且包含errors属性
  if (typeof data === 'object' && data !== null && 'errors' in data) {
    const errors = data.errors;
    // 第二层：确认errors是数组且不为空
    if (Array.isArray(errors) && errors.length > 0) {
      const firstError = errors[0];
      // 第三层：确认第一个错误项是包含detail字符串的对象
      if (typeof firstError === 'object' && firstError !== null && 'detail' in firstError && typeof firstError.detail === 'string') {
        const { detail } = firstError;
        // 此时detail的类型被TypeScript明确为string，ESLint不会报错
        console.log('错误详情:', detail);
      }
    }
  }
}

方法2：自定义类型守卫函数（复用性更强）

如果需要在多个地方校验JSON:API错误响应，可以定义一个类型守卫函数，统一校验逻辑：

// 定义类型守卫，明确符合JSON:API错误格式的结构
function isJsonApiErrorResponse(data: unknown): data is { errors: Array<{ detail: string }> } {
  if (typeof data !== 'object' || data === null) return false;
  if (!('errors' in data)) return false;
  
  const errors = data.errors;
  if (!Array.isArray(errors) || errors.length === 0) return false;
  
  const firstError = errors[0];
  return typeof firstError === 'object' && firstError !== null && 'detail' in firstError && typeof firstError.detail === 'string';
}

function handleResponseErrors(data: unknown) {
  if (isJsonApiErrorResponse(data)) {
    // TypeScript此时已确认data符合定义的结构，data.errors[0].detail是string类型
    const { detail } = data.errors[0];
    console.log('错误详情:', detail);
  }
}

关键要点 #

• 必须逐层校验嵌套结构：从顶层对象到数组，再到数组元素的属性，每一步都要明确类型。
• 类型守卫或多层条件判断的核心是给TypeScript提供足够的类型信息，让它能自动收窄变量类型，ESLint的安全规则会基于TypeScript的类型推断结果放行。

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