uni-app中filter指css滤镜而非vue过滤器,vue 3已移除vue.filter;api错误应通过请求拦截器或响应处理统一捕获,区分网络层与业务层错误并分别应对。

uni-app里filter不是Vue的过滤器,而是CSS滤镜
很多人搜“uni-app 过滤器 错误信息”,其实是被术语误导了。filter在uni-app中默认指向CSS的filter属性(比如grayscale()),它跟处理API错误完全无关。Vue 2时代的全局过滤器Vue.filter在Vue 3 + uni-app(尤其是Vue3项目)中已被移除,不再支持。
API错误信息该用拦截器或响应式处理
真正该做的,是统一拦截HTTP响应,而不是找“过滤器”。常见错误如401、403、500或业务码{ code: 1001, msg: "权限不足" },靠CSS做不到,得靠逻辑层。
- 用
uni.request封装成自定义请求函数,在fail和success回调里判断res.statusCode和res.data.code - 若用
axios或uni-app-request等库,直接配interceptors.response.use,集中处理错误码映射提示语 - 避免在每个
api.xxx()后面重复写if (res.code !== 200) uni.showToast(...) - 业务错误文案建议抽成对象,例如:
{ 1001: '登录已过期,请重新登录', 1002: '无操作权限' },方便维护和多语言替换
computed或watch里做错误状态转换容易踩坑
有人试图用computed把原始错误数据“过滤”成用户友好的提示,但要注意:如果原始数据是异步获取的(比如ref(null)初始值),computed可能返回undefined或空字符串,导致页面渲染异常或提示不出现。
- 推荐用
watch监听错误响应,触发uni.showToast或更新errorText响应式变量 - 不要在
computed里调用uni.showToast——副作用不能放计算属性里 - 若必须用
computed生成提示文案,确保入参有默认值,例如:computed(() => error.value?.msg || '未知错误') - 注意条件编译:小程序端
uni.showToast不支持icon: 'none'在旧版基础库,H5端则可能需改用alert降级
后端返回结构不一致时,错误提取逻辑要健壮
真实场景中,不同接口的错误字段名可能不统一:有的叫message,有的叫msg,有的嵌套在data里,有的直接在顶层。硬写res.data.msg很容易报Cannot read property 'msg' of undefined。
- 统一响应格式应在项目初期就约定,前端解析才可控
- 临时兼容可写工具函数,例如:
getErrorMessage(res) { return res?.data?.msg || res?.data?.message || res?.msg || res?.message || '请求失败' } - 对
null、undefined、string、object类型都做防御性检查,别假设后端永远返回标准结构 - 真机调试时,网络中断或超时返回的是
fail回调里的errMsg(如"request:fail timeout"),这个和业务错误分开处理
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











