错误处理
Nuxt 是一个全栈框架，这意味着在不同的上下文中可能会发生多种无法预防的用户运行时错误
- Vue 渲染生命周期中的错误 (SSR & CSR)
- 服务器和客户端启动错误 (SSR + CSR)
- Nitro 服务器生命周期中的错误 (
server/目录) - 下载 JS 代码块时出错
Vue 错误
你可以使用 onErrorCaptured 钩子来捕获 Vue 错误。
此外，Nuxt 提供了一个 vue:error 钩子，如果任何错误传播到顶层，该钩子将被调用。
如果你正在使用错误报告框架，你可以通过 vueApp.config.errorHandler 提供全局处理程序。它将接收所有 Vue 错误，即使这些错误已被处理。
export default defineNuxtPlugin((nuxtApp) => {
nuxtApp.vueApp.config.errorHandler = (error, instance, info) => {
// handle error, e.g. report to a service
}
// Also possible
nuxtApp.hook('vue:error', (error, instance, info) => {
// handle error, e.g. report to a service
})
})
vue:error 钩子基于 onErrorCaptured 生命周期钩子。启动错误
如果在启动 Nuxt 应用程序时发生任何错误，Nuxt 将调用 app:error 钩子。
这包括
- 运行 Nuxt 插件
- 处理
app:created和app:beforeMount钩子 - 将 Vue 应用渲染为 HTML (在 SSR 期间)
- 挂载应用（在客户端），尽管你应该使用
onErrorCaptured或vue:error处理这种情况 - 处理
app:mounted钩子
Nitro 服务器错误
你目前无法为这些错误定义服务器端处理程序，但可以渲染错误页面，请参阅 渲染错误页面 部分。
JS 代码块错误
你可能会由于网络连接失败或新部署（这会使你旧的、哈希的 JS 代码块 URL 失效）而遇到代码块加载错误。Nuxt 提供了内置支持来处理代码块加载错误，方法是在路由导航期间代码块加载失败时执行硬重载。
你可以通过将 experimental.emitRouteChunkError 设置为 false（完全禁用对此类错误的钩子）或 manual（如果你想自己处理）来更改此行为。如果你想手动处理代码块加载错误，你可以查看 自动实现 以获取灵感。
错误页面
fatal: true 创建的错误）时，它将渲染 JSON 响应（如果请求头为 Accept: application/json）或触发全屏错误页面。错误可能在服务器生命周期中发生，当
- 处理你的 Nuxt 插件
- 将你的 Vue 应用渲染为 HTML
- 服务器 API 路由抛出错误
它也可能在客户端发生，当
- 处理你的 Nuxt 插件
- 在挂载应用程序之前 (
app:beforeMount钩子) - 挂载你的应用，如果错误没有被
onErrorCaptured或vue:error钩子处理 - Vue 应用在浏览器中初始化和挂载 (
app:mounted)。
通过在你的应用程序的源代码目录中添加 ~/error.vue，与 app.vue 并列，来自定义默认错误页面。
<script setup lang="ts">
import type { NuxtError } from '#app'
const props = defineProps({
error: Object as () => NuxtError
})
const handleError = () => clearError({ redirect: '/' })
</script>
<template>
<div>
<h2>{{ error.statusCode }}</h2>
<button @click="handleError">Clear errors</button>
</div>
</template>
对于自定义错误，我们强烈建议使用可以在页面/组件 setup 函数中调用的 onErrorCaptured 组合式函数，或者可以在 nuxt 插件中配置的 vue:error 运行时 nuxt 钩子。
export default defineNuxtPlugin(nuxtApp => {
nuxtApp.hook('vue:error', (err) => {
//
})
})
当你准备移除错误页面时，你可以调用 clearError 辅助函数，该函数接受一个可选的重定向路径（例如，如果你想导航到一个“安全”页面）。
$route 或 useRouter，因为如果插件抛出错误，那么在清除错误之前它不会重新运行。useError 来检查是否正在处理错误。错误工具
useError
function useError (): Ref<Error | { url, statusCode, statusMessage, message, description, data }>
此函数将返回正在处理的全局 Nuxt 错误。
createError
function createError (err: string | { cause, data, message, name, stack, statusCode, statusMessage, fatal }): Error
创建一个带有附加元数据的错误对象。你可以传递一个字符串设置为错误 message，或者传递一个包含错误属性的对象。它在你的应用程序的 Vue 和 Server 部分都可用，并且旨在被抛出。
如果你抛出一个使用 createError 创建的错误
- 在服务器端，它将触发一个全屏错误页面，你可以使用
clearError清除它。 - 在客户端，它将抛出一个非致命错误供你处理。如果你需要触发一个全屏错误页面，那么你可以通过设置
fatal: true来做到这一点。
<script setup lang="ts">
const route = useRoute()
const { data } = await useFetch(`/api/movies/${route.params.slug}`)
if (!data.value) {
throw createError({
statusCode: 404,
statusMessage: 'Page Not Found'
})
}
</script>
showError
function showError (err: string | Error | { statusCode, statusMessage }): Error
你可以在客户端的任何时候调用此函数，或者（在服务器端）直接在中间件、插件或 setup() 函数中调用。它将触发一个全屏错误页面，你可以使用 clearError 清除它。
建议改为使用 throw createError()。
clearError
function clearError (options?: { redirect?: string }): Promise<void>
此函数将清除当前处理的 Nuxt 错误。它还接受一个可选的重定向路径（例如，如果你想导航到一个“安全”页面）。
在组件中渲染错误
Nuxt 还提供了一个 <NuxtErrorBoundary> 组件，允许你在你的应用程序中处理客户端错误，而无需用错误页面替换你的整个站点。
此组件负责处理在其默认插槽中发生的错误。在客户端，它将阻止错误冒泡到顶层，并将渲染 #error 插槽。
#error 插槽将接收 error 作为 prop。（如果你设置 error = null，它将触发重新渲染默认插槽；你需要确保错误首先完全解决，否则错误插槽将只会被渲染第二次。）
<template>
<!-- some content -->
<NuxtErrorBoundary @error="someErrorLogger">
<!-- You use the default slot to render your content -->
<template #error="{ error, clearError }">
You can display the error locally here: {{ error }}
<button @click="clearError">
This will clear the error.
</button>
</template>
</NuxtErrorBoundary>
</template>