在Vue应用中使用vuex时，我们经常会遇到“TypeError: Cannot read property 'xxx' of undefined”的错误。这个错误的出现通常和代码的逻辑结构、vuex模块及其状态的定义、调用方法等相关。本文将详细介绍出现该错误时如何进行排查和解决。
一、错误的原因与排查
1.没有使用mapState等辅助函数
使用vuex时，我们应该使用辅助函数如mapState、mapGetters、mapMutations、mapActions等来获取到store中的状态。如果我们没有使用这些辅助函数，而是手写了读取store中状态的代码，就很容易出现“TypeError: Cannot read property 'xxx' of undefined”这样的错误。
立即学习“前端免费学习笔记（深入）”；
排查方法：检查代码中是否存在手写读取store状态的代码，如果有，考虑使用辅助函数进行替换。
2.访问未定义的模块或相应的状态
如果我们在Vuex中定义了模块，而且在组件中使用了模块中的某个状态，但是定义的模块却没有被加载或者被加载后状态没有被初始化，就会出现“TypeError: Cannot read property 'xxx' of undefined”这样的错误。
排查方法：检查组件是否正确访问了所需的vuex模块，并确保模块在组件使用之前已被定义和初始化。
3.使用store.state.xxx而store本身为undefined
如果在组件中使用store.state.xxx，而store本身为undefined，就会出现“TypeError: Cannot read property 'xxx' of undefined”这样的错误。
排查方法：检查组件中引用store的代码，确保store已经被正确实例化。
4.异步请求未返回数据，导致访问状态失败
如果我们在Vuex中进行了异步请求，但是在请求返回数据之前就访问了该状态，就会出现“TypeError: Cannot read property 'xxx' of undefined”这样的错误。
排查方法：确保在访问vuex状态之前，已经获取到了相关的异步请求数据。
二、解决方案
1.使用mapState等辅助函数
在组件中的computed属性中使用mapState等辅助函数，如下所示：
import { mapState } from 'vuex'
export default {
computed: {
...mapState({
xxx: state => state.xxx
})
}
}2.正确访问模块及相应状态
确保模块在组件使用之前已被定义和初始化：
const myModule = {
state: {
xxx: 'xxx'
},
mutations: {},
actions: {},
getters: {}
}
export default new Vuex.Store({
modules: {
myModule
}
})在组件中使用模块中的一项状态：
import { mapState } from 'vuex'
export default {
computed: {
...mapState({
xxx: state => state.myModule.xxx
})
}
}3.确保store已被正确实例化
在main.js文件中正确初始化store：
import Vue from 'vue'
import Vuex from 'vuex'
import store from './store/index'
Vue.use(Vuex)
new Vue({
store,
//...
})4.确保在访问vuex状态之前已经获取到异步请求数据
如下所示：
import { mapState } from 'vuex'
export default {
computed: {
...mapState({
xxx: state => state.xxx
})
},
created() {
// 异步请求获取数据
this.$http.get('/xxx').then(res => {
// 将数据提交到vuex store中
this.$store.commit('SET_X', res.data)
}).catch(err => {})
}
}总结：
以上就是遇到“TypeError: Cannot read property 'xxx' of undefined”错误时的排查和解决方案。在日常开发中，我们需要时刻注意检查vuex状态的引用是否正确，如果有任何问题都要尽早解决，以确保应用的稳定性和可靠性。
