在 JavaScript 开发中，处理类似 user.address.city 这样的深层嵌套属性是常见需求，但直接访问可能导致灾难性的 Cannot read property 'city' of undefined 错误。本文将分享几种专业级解决方案，助你优雅避开这些陷阱。

 解决方案一：防御式条件检查（传统可靠）

通过逐层显式验证确保每层对象存在：

function getCity(user) {
  if (user && 
      user.address && 
      typeof user.address === 'object' && 
      'city' in user.address) {
    return user.address.city;
  }
  return '未知地区';
}

// 测试用例
const user1 = { address: { city: '北京' } };
const user2 = { address: null };
const user3 = undefined;

console.log(getCity(user1)); // "北京"
console.log(getCity(user2)); // "未知地区"
console.log(getCity(user3)); // "未知地区"

优点：

• 兼容所有 JavaScript 环境

• 精确控制每层验证逻辑

• 可添加额外类型检查（如 typeof === 'object'）

缺点：

• 嵌套过深时代码冗长

• 重复性代码增加维护成本

解决方案二：可选链操作符（现代首选）

ES2020 引入的可选链操作符（?.）是当前最优雅的解决方案：

// 安全访问嵌套属性
const city = user?.address?.city;

// 配合空值合并设置默认值
const safeCity = user?.address?.city ?? '未知地区';

// 安全方法调用
const street = user?.getAddress?.().street;

关键特性：

• 遇到 null 或 undefined 立即停止并返回 undefined

• 可与函数调用结合：obj.method?.()

• 支持动态属性：obj?.[dynamicKey]

浏览器兼容性：

• 现代浏览器和 Node.js 14+ 原生支持

• 旧环境通过 babel 插件 @babel/plugin-proposal-optional-chaining 转译

解决方案三：工具函数封装

创建可复用的安全访问函数：

function deepGet(obj, path, defaultValue = null) {
  // 路径格式处理：'a.b.c' 或 ['a', 'b', 'c']
  const keys = Array.isArray(path) ? path : path.split('.');
  
  let current = obj;
  for (const key of keys) {
    // 遇到 null/undefined 提前终止
    if (current?.[key] === undefined) return defaultValue;
    current = current[key];
  }
  
  return current ?? defaultValue;
}

// 使用示例
const location = deepGet(user, 'address.location', {});
const postCode = deepGet(user, ['address', 'postalCode'], '000000');

增强功能方向：

1. 支持数组索引：'contacts[0].phone'

2. 添加类型校验：确保末级值为特定类型

3. 错误追踪：记录访问失败路径

解决方案四：使用 Lodash 等工具库

对已使用 Lodash 的项目，_.get() 是最安全便捷的选择：

import _ from 'lodash';

// 基本使用
const city = _.get(user, 'address.city', '默认城市');

// 支持复杂路径
const firstFriend = _.get(user, 'friends[0].name', '无好友');

// 存在性检查（不取值）
const hasAddress = _.has(user, 'address.coordinates.latitude');

对比原生优势：

• 支持数组索引和特殊字符路径

• 经过严格测试的边界情况处理

• 统一代码风格降低认知成本

特殊场景处理技巧

Map/Set 集合检查：

// Map 类型检查
const map = new Map([['user', { name: 'Alice' }]]);
const hasUser = map.has('user') && 'name' in map.get('user');

类数组对象处理：

// 安全访问 dom 集合
const firstChild = document.querySelectorAll('div')?.[0];

可选链与类型守卫结合：

interface Address {
  city?: string;
  location?: { lat: number; lng: number };
}

// TypeScript 中确保类型安全
const coordinates = (user.address as Address)?.location;

方案选择指南

最佳实践总结

优先使用可选链：现代项目中首选 ?. 语法，配合 ?? 设置默认值

防御性编程：对第三方数据源始终保持 "不信任" 验证原则

深度检查分离：属性访问与业务逻辑分离，避免多层嵌套表达式

TypeScript强化：结合类型守卫确保编译时安全：

function isAddress(obj: any): obj is Address {
  return obj && typeof obj === 'object';
}

if (isAddress(user.address)) {
  // 此处可安全访问 address 所有属性
}

通过合理运用这些技术，不仅能彻底消除恼人的 undefined 访问错误，更能构建出健壮的前端数据访问层。随着可选链操作符的普及，2023年全球使用率已超过92%（来源：MDN 兼容性数据），是现代Web开发的必备技能。

本文内容仅供个人学习、研究或参考使用，不构成任何形式的决策建议、专业指导或法律依据。未经授权，禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载，请保留原文来源信息，不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持！

链接: https://fly63.com/article/detial/12727