Vue 3 中请求与响应拦截器怎么在响应前统一解构后端返回数据

雨枫小哥_1652

雨枫小哥_1652

2026-11-17

658人浏览

原创

Vue 3响应拦截器统一解构后端数据,需在success回调中返回response.data,使组件直接获取data字段内容;若需业务状态码处理,可采用包装式解构挂载_code、_msg等字段;须规避非标准接口、blob下载等场景导致的解构失效。

vue 3 中请求与响应拦截器怎么在响应前统一解构后端返回数据

在 Vue 3 项目中,响应拦截器统一解构后端返回数据,核心是把“剥掉外层包装”这步逻辑收口到 response.interceptors.use 的成功回调里,让所有组件拿到的都是干净的 data 字段内容,而不是整个 { code: 0, msg: '', data: {...} } 套壳结构。

明确后端统一响应格式

解构的前提是后端有约定俗成的结构,比如:

  • 成功时:返回 { code: 0, msg: 'ok', data: { user: {...} } }
  • 失败时:仍返回同结构,如 { code: 401, msg: '登录过期', data: null }

若格式不固定(如有时带 data,有时直接返回数组),需先和后端对齐,否则拦截器无法稳定解构。

在响应拦截器中提取 data 并透传

在 src/utils/request.ts 的响应拦截器成功分支里,直接返回 response.data:

request.interceptors.response.use(
  (response) => {
    // ✅ 统一解构:只把 data 字段往下传
    return response.data;
  },
  (error) => {
    // 错误分支不做解构,原样 reject
    return Promise.reject(error);
  }
);

这样,调用方写 api.get('/user') 后,.then(res => console.log(res)) 打印出来的就是 { user: {...} },不是整个响应对象。

Vue工具箱(免费版)
Vue工具箱(免费版)

规避 Vue 3 常见陷阱:响应式、ref 与 reactive、computed 时机与组合式 API 优选实践。

下载

兼顾业务状态码处理(可选增强)

如果后端还要求根据 code 做全局判断(如 code !== 0 视为业务失败),就不能简单只返回 data。此时可改用“包装式解构”:

  • 保留原始 response 结构,但把 data 提前挂到顶层
  • 同时注入 code 和 msg,方便组件快速判断

示例写法:

return {
  ...response.data,
  _code: response.data.code,
  _msg: response.data.msg,
  _success: response.data.code === 0
};

组件中就能写 if (res._success) { ... },既保持解构干净,又不丢失业务语义。

注意避坑点

以下情况容易导致解构失效或报错:

  • 后端某些接口没遵循统一格式(比如上传接口直接返回字符串),可在拦截器里加白名单或类型判断,跳过解构
  • 使用 responseType: 'blob' 下载文件时,不能解构 response.data(它是 Blob 对象),需单独配置不走该拦截逻辑
  • 未在错误分支 return Promise.reject(error),会导致错误被吞,组件收不到报错

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vue.js vue vue 3

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3063

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7530

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7146

10

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3063

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6703

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7530

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7478

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1063

5

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

1794

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 17.6万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习