TypeScript如何从带可选字段的接口正确派生嵌套属性类型

安全阿岳

2026-9-1

报错原因

connected_account被标记为可选属性后，IEmployee['settings']['external_payment']['connected_account']的推导结果是「定义的账户对象类型 | undefined」的联合类型。直接在这个联合类型上访问status属性时，TS会判定存在从undefined上读取属性的风险，因此抛出tsserver 2339类型错误：
tsserver 2339类型错误截图
错误提示原文：

[tsserver 2339] [E] Property 'status' does not exist on type '{ status:
string; last4?: string | undefined; account_type_code?: string | undefined;
bank_account_name?: string | undefined; verification_method?: string |
undefined; institution: { ...; }; } | undefined'.

解决方法

核心思路是先排除联合类型里的undefined分支，再读取status的类型，推荐两种可落地的写法：

写法1：使用TS内置NonNullable工具类型（最简洁）
NonNullable会自动剔除联合类型中的null和undefined，直接拿到目标对象类型后再取属性：

export interface Employee {
  settings: {
    external_payment: {
      connected_account?: {
        status: NonNullable<IEmployee['settings']['external_payment']['connected_account']>['status'];
      };
    },
  },
}

写法2：抽离公共类型别名（可读性更高）
如果后续还要复用connected_account下的其他字段，可以先抽离类型别名，避免重复写长链式索引：

// 先拿到connected_account的联合类型，排除undefined后得到完整对象类型
type NonNullConnectedAccount = NonNullable<IEmployee['settings']['external_payment']['connected_account']>;

export interface Employee {
  settings: {
    external_payment: {
      connected_account?: {
        status: NonNullConnectedAccount['status'];
        // 后续要取其他字段直接引用即可，比如last4: NonNullConnectedAccount['last4']
      };
    },
  },
}