前言

在开发Vue项目中，要求遇到报错显示一个报错页面，而不是把报错信息显示。

操作步骤

大纲

1. 使用Vue自带的报错捕获机制添加报错信息
2. 在接口报错部分添加相同机制
3. 把报错信息添加到Vuex中方便全局使用
4. 添加报错页面备用
5. app页面添加if判断替换报错界面

1.使用Vue自带的报错捕获机制添加报错信息

main.js

// 设置全局错误处理
app.config.errorHandler = (err) => {
    // 存储错误信息到Vuex中
    store.commit('setError', err.message || '未知错误');
}

2.在接口报错部分添加相同机制

catch (error) {
    console.error('API 请求错误:', error);
    // 更新 Vuex 错误信息
    store.dispatch('setError', error.message || '接口请求失败');
    throw error;
  } 

3.把报错信息添加到Vuex中方便全局使用

import { createStore } from 'vuex'
export default createStore({
  state: {
    error: null, // 添加 error 信息
  },
  mutations: {
    setError(state, payload) {
      state.error = payload;
    }
  },
  actions: {
    setError({ commit }, payload) {
      commit('setError', payload);
    }
  },
  getters: {
    getError: (state) => state.error,
  },
})

4.添加报错页面备用

<!-- ErrorPage.vue -->
<template>
  <div class="error-page">
    <h2>发生错误</h2>
    <p>{{ message }}</p>
    <p>请稍后再试，出现了问题。</p>
  </div>
</template>

<script>
export default {
  name: 'ErrorPage',
  props: {
    message: {
      type: String,
      default: '未知错误'
    }
  }
}
</script>

<style scoped>
.error-page {
  display: flex;
  flex-direction: column;
  justify-content: center;
  align-items: center;
  height: 100vh;
  text-align: center;
  background-color: #f8d7da;
  color: #721c24;
}

h2 {
  font-size: 2rem;
}

p {
  font-size: 1rem;
  color: #555;
}
</style>

5.app页面添加if判断替换报错界面

<ErrorPage v-if="errorMessage" :message="errorMessage" />
<!-- 其他页面内容 -->
<div v-else class="common-layout">
	……
</div>

效果

备注：vue项目中Uncaught runtime errors:怎样关闭

使用vue-cli新建的vue项目，当出现编译错误或警告时，在浏览器中显示全屏覆盖，如下图，此报错在生产环境下并不会出现。

通过看控制台，找到关键词webpack

可以明显的看出来是webpack-dev-server弄出来的。

解决办法
在vue.config.js中添加如下配置

module.exports = defineConfig({
	...
	devServer: {
    client: {
      overlay: false
    }
  }
})

备注部分此处参考：https://blog.csdn.net/qq_36877078/article/details/131175355

鸣谢。