症状
编译器报 TS2339，称某类型上不存在该属性，尽管运行时该值确有它。这通常意味着值是联合类型而只有部分成员声明了该属性，或泛型未加约束，或接口漏掉了数据实际携带的字段。用 as any 断言只是掩盖差异而非解决。
诊断
运行 tsc 读取所报类型；用 in 运算符或类型守卫先收窄；检查接口定义是否遗漏该字段。
npx tsc --noEmit根因
编译器看到的类型未声明所访问的属性，原因是属性只属于联合的部分成员，或类型定义不完整。
修复
用 in 运算符、可辨识联合或类型守卫在访问前收窄，让编译器知道属性存在；若数据确有该字段则补进接口；动态键使用索引签名而非强制转换。
验证
重新运行类型检查确认错误消失，再跑测试确认在被覆盖的路径上属性确实存在。类型与运行时都通过才算修复。
常见陷阱
用 any 断言绕过会失去后续属性访问的保护；应完善类型而非抑制检查。