【Nuxt】路由中间件和 definePageMeta

路由中间件

Nuxt 提供了一个可定制的路由中间件,用来监听路由的导航,包括:局部和全局监听(支持再服务器和客户端执行)

路由中间件分为三种:

匿名(或内联)路由中间件

在页面中使用definePageMeta函数的 middleware 属性定义,可监听局部路由。当注册多个中间件时,会按照注册顺序来执行。

definePageMeta({
  middleware: [
      function (to, from) {
        console.log(to, from)
      }
      // 可以写多个中间件 ....
  ]
})

命名路由中间件

在middleware目录下定义,并会自动加载中间件。命名规范(kebab-case)

  • server:·刷新浏览器的会在服务器端执行
  • client:在客户端切换路由,只会在客户端执行

@/middleware/home.ts

export default defineNuxtRouteMiddleware(function (to, from) {
    console.log('第二个中间件', to, from)
})
definePageMeta({
  middleware: [
      function (to, from) {
        console.log('第一个中间件', to, from)
      },
      "home"
  ]
})

全局路由中间件

优先级最高,支持两端。添加 global 后缀默认为全局中间件。

@/middleware/auth.global.ts

export default defineNuxtRouteMiddleware(function (to, from) {
    if (to.path === '/login') {
        return
    } else {
        if (!useAuthStore().isAuthenticated) {
            return navigateTo('/login')
        }
    }
})

definePageMeta

define-page-meta

definePageMeta是一个编译器宏,可以用它为位于pages/目录中的页面组件设置元数据。

definePageMeta({
  // 校验路由是否放行
  validate: (route)=> {
    // return !!route.query.id // 为 true 放行 为false 会跳转到默认的 404 页面
    // 还可以直接返回一个带有statusCode/statusMessage的对象,以立即以错误响应(不会检查其他匹配)
    return {
      statusCode: 404,
      // 这里的错误信息最好写英文 写中文可能会有奇怪的 bug O.o
      statusMessage: "不论怎么样都不放行 O.o"
    }
  },
  // 中间件
  middleware: [
      function (to, from) {
        console.log('第一个中间件', to, from)
      },
      "home"
  ]
})

我们也可以自定义 404 页面,只需在根目录下创建一个 error.vue 的组件即可。

error.vue

<script setup>
const props = defineProps({
  error: Object
})
const toHome = () => {
  clearError({
    redirect: '/'
  })
}
</script>

<template>
  <div>error: {{ error }}</div>
  <button @click="toHome">回首页</button>
</template>
<think>好的,我现在需要帮助用户解决在Nuxt 3中配置中间件来拦截处理token的问题。首先,我得回忆一下Nuxt 3的中间件机制,之前的版本有什么不同。记得Nuxt 3引入了Composition API,中间件可能有所变化。用户提到了他们看到的引用内容,其中涉及中间件的执行顺序JWT的使用,所以可能需要结合这些信息。 首先,Nuxt 3的中间件可以放置在middleware目录下,自动加载,或者通过页面配置。中间件分为路由中间件服务器中间件,但用户的问题可能更关注于路由中间件,用于前端路由的拦截。用户想拦截请求中的token,可能是从cookie或请求头中获取,然后验证。 接下来,我需要确定中间件的基本结构。在Nuxt 3中,中间件应该是导出默认的函数,接收context作为参数。例如,定义一个auth中间件,检查请求中的token是否存在,如果不存在则重定向到登录页。 然后,如何处理token?通常,token可能存储在cookie里,或者Authorization头中。中间件需要读取这些地方的值。例如,使用useCookie来获取cookie中的token,或者从请求头中解析Bearer token。 另外,需要考虑如何验证token的有效性。可能需要使用jsonwebtoken库来解码验证JWT。但需要注意,前端中间件可能无法安全地存储密钥,所以可能只做简单的存在性检查,而真正的验证应在后端进行。 还需要考虑中间件的注册方式。在页面或布局中,通过definePageMeta来指定使用的中间件。例如,在需要权限的页面添加auth中间件。 可能的问题点:中间件的执行顺序是否正确?用户提到的引用中有中间件执行顺序的例子,需要确保中间件在正确的时机执行。例如,在nuxt.config中全局注册的中间件,布局中的中间件,页面中的中间件,它们的执行顺序是否会影响token的处理。 此外,错误处理也是关键。如果token无效或不存在,应该重定向到登录页面,并终止后续处理。 最后,给出一个示例代码,展示中间件的编写配置步骤,包括安装依赖、创建中间件文件、注册中间件到页面或全局。同时,提醒用户安全注意事项,比如不在客户端存储敏感信息,使用httpOnly的cookie等。 可能还需要回答相关问题,比如中间件的执行顺序、如何全局注册、服务器端中间件路由中间件的区别,以及如何安全存储token。需要确保这些内容覆盖用户可能有的疑问,并参考提供的引用资料中的信息。</think>在Nuxt 3中配置中间件拦截token的实现步骤如下: ### 1. 创建中间件文件 在项目根目录新建 `middleware/auth.global.ts`(全局中间件)或 `middleware/auth.ts`(局部中间件),添加以下代码: ```typescript // middleware/auth.ts export default defineNuxtRouteMiddleware((to, from) => { // 从cookie获取token(推荐方式) const token = useCookie('auth_token').value // 或从请求头获取 // const headers = useRequestHeaders(['authorization']) // const token = headers.authorization?.split('Bearer ')[1] if (!token) { return navigateTo('/login') } // 可选:验证token有效性 try { const decoded = jwt.verify(token, 'your-secret-key') useAuthStore().setUser(decoded) } catch (err) { useCookie('auth_token').value = null return abortNavigation('令牌已过期,请重新登录') } }) ``` ### 2. 注册中间件 在需要拦截的页面中配置: ```typescript // pages/protected.vue <script setup> definePageMeta({ middleware: ["auth"] }) </script> ``` 或全局注册(修改nuxt.config.ts): ```typescript // nuxt.config.ts export default defineNuxtConfig({ routeRules: { '/protected/**': { middleware: ['auth'] } } }) ``` ### 3. Token处理流程 1. **存储Token**:登录成功后设置cookie ```typescript // pages/login.vue const login = async () => { const { token } = await $fetch('/api/login', { method: 'POST' }) useCookie('auth_token').value = token } ``` 2. **验证机制**:建议后端配合实现接口级验证 ### 安全注意事项[^2] 1. 使用`httpOnly``secure`标记的cookie存储token 2. 敏感操作需在后端二次验证token 3. JWT密钥不应暴露在前端代码中 ```mermaid sequenceDiagram 客户端->>中间件: 发起请求 中间件->>验证模块: 检查cookie/header中的token alt token有效 验证模块-->>中间件: 允许通过 中间件->>页面: 正常渲染 else token无效 验证模块-->>中间件: 拦截请求 中间件->>客户端: 重定向到/login end ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

秀秀_heo

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值