这是 uni-app 中因数据未初始化或异步时机不当导致的典型错误。常见于 onLoad 中直接访问未定义的 this.userInfo、this.$refs 或 getApp().globalData，需显式初始化、判空、用 $nextTick 或可选链，并注意平台差异与生命周期顺序。
为什么 Cannot read property 'xxx' of undefined 总在页面 onLoad 里报？
这是 uni-app 里最典型的“还没初始化就去读”的问题。比如你在 onLoad 里直接访问 this.userInfo.name，但 this.userInfo 还是 undefined —— 因为它可能来自异步请求、或还没被 data() 初始化好。
常见错误现象：onLoad 中调用 this.$refs.xxx 报错、访问 this.options.id 但 this.options 是空对象、this.store.state.user 拿不到值却没判空。
- 确保所有依赖数据在读取前已定义：在
data()中显式初始化，比如userInfo: null或{}，而不是留空 - 异步数据必须加判空：用
if (this.userInfo && this.userInfo.name)，别直接链式访问this.userInfo.name - 避免在
onLoad里直接操作$refs：DOM 节点此时大概率未挂载，改用$nextTick包一层 - 使用可选链操作符（ES2020+）：uni-app 3.0+ 支持
this.userInfo?.name，但 H5 端需确认基础库版本 ≥ 3.2.0
getApp().globalData 读不到值？检查这三处
很多人把全局变量塞进 getApp().globalData，结果在子页面里读出来是 undefined，其实不是 API 有问题，而是生命周期和赋值时机没对上。
使用场景：登录态、用户 token、配置项等需要跨页面共享的简单数据。
-
globalData是个普通对象，不响应式：你改了它，页面不会自动更新，得手动this.$forceUpdate()或用事件通知 - 赋值必须早于页面加载：不能在某个页面的
onLoad里才首次赋值给getApp().globalData.token，否则其他已加载的页面读不到 - 注意 App.vue 的
onLaunch和onShow执行顺序：冷启动时onLaunch先执行，热启动时只触发onShow，token 刷新逻辑得覆盖两种情况
组件里 this.$parent 或 this.$children 访问失败？别硬连
在自定义组件中写 this.$parent.someMethod()，运行时报 Cannot read property 'someMethod' of undefined —— 这说明父子关系没建立好，或者你假设的父组件根本不是当前组件的直接父级。
性能影响：频繁通过 $parent 向上穿透，会破坏组件封装性，也容易因层级变动导致崩溃。
- 优先用
props+$emit：把方法作为prop传下来，比挖祖宗更稳 - 如果必须跨多层通信，用
provide / inject（Vue 2.6+），uni-app 2.9+ 已支持，比$parent更可靠 - 不要在
created钩子中访问$parent：此时父组件可能还未完成实例化，改到mounted或用$nextTick - H5 和小程序平台差异：微信小程序中
$children在某些条件下为空数组，别依赖它做关键逻辑
真机调试时突然报这个错，但开发工具里不报？
这是环境差异导致的典型问题。开发工具模拟的是完整 JS 运行时，而真机（尤其低端安卓机）JS 引擎更严格，对未定义属性的访问容忍度更低。
兼容性影响：iOS WKWebView、微信安卓 X5 内核、支付宝小程序容器，对 undefined.x 的报错策略各不相同。
- 开启 uni-app 的「严格模式」编译：在
vue.config.js中加compilerOptions.strict: true，提前暴露潜在问题 - 检查
main.js是否漏了 polyfill：比如Object.assign、Promise，老安卓机不原生支持，会导致后续逻辑中断，间接引发属性读取失败 - 真机日志要看完整堆栈：微信开发者工具真机调试里点开报错详情，重点看哪一行触发的，经常是前面某个异步失败后，后面代码继续执行导致的连锁报错
最容易被忽略的是：你以为的“默认值”其实根本没生效——比如 data() 里写 list: this.defaultList，但 this.defaultList 是个不存在的方法，这句执行时就返回 undefined，后续所有基于 list 的操作都崩了。
