症状
代码抛出 TypeError: Cannot read properties of undefined（读取某属性），说明点号左侧的对象是 undefined，而非属性名错误。它常在重构后、特定数据上，或异步调用结果未 resolve 就被使用时出现。读取堆栈能定位确切表达式，下一步是找出该对象本应来自何处。
诊断
用 –stack-trace-limit 读取堆栈定位行；访问前打印接收者；搜索赋值处追踪来源。
node --stack-trace-limit=50 app.js根因
访问处对象为 undefined，因此属性访问抛错。该值要么从未被赋值、要么在使用之后才赋值、要么被某次查找替换为 undefined。
修复
缺失可接受时用可选链守卫，不可接受时用显式检查并抛出清晰错误；使用异步结果前先 await；修正赋值路径使对象在访问处已存在。仅加守卫无法修复本不该为 undefined 的值。
验证
重跑失败路径确认错误消失，并确认属性持有预期值而非仅仅不抛错。不抛错是必要而非充分条件，值也必须正确。
常见陷阱
对每个访问都加 ?. 会把真实的数据缺失静默化；应区分正常缺失与逻辑错误。