最常见原因是vue.filter未执行或注册过晚，必须在main.js中new app()前注册；小程序平台不支持过滤器；vue 3已移除该api；需严格校验value类型并改用computed/method替代。
Vue.filter 没注册或注册太晚
模板里写 {{ value | myFilter }} 却报 is not a function，最常见原因是 Vue.filter() 根本没执行，或者在 new Vue() 之后才调用。uni-app 启动流程中，main.js 是唯一能确保全局 filter 生效的位置，且必须放在 new App({ ... }) 或 new Vue({ ... }) 之前。
- 检查
main.js是否 import 了过滤器文件，且Vue.filter('name', fn)在App实例创建前调用 - 不要把
Vue.filter写在App.vue的created、onLaunch里——此时组件已开始编译，filter 不会被识别 - 确认没有拼错函数名：
Vue.filter('formatDate', ...)和模板中{{ d | formatDate }}必须完全一致（大小写、下划线）
过滤器函数签名错误导致 value 为 undefined
报错常出现在过滤器内部，比如调用 value.toString() 时 value 是 undefined，最终抛出 is not a function（因为 undefined.toString 不存在）。根本原因是函数签名没按 Vue 2 要求写：第一个参数必须是管道符左边传入的值。
- ❌ 错误写法：
Vue.filter('toUpper', (str) => str?.toUpperCase())—— 看似没问题，但若模板传的是undefined，str就是undefined，str?.toUpperCase返回undefined，后续再被当函数调用就崩了 - ✅ 正确写法：
Vue.filter('toUpper', (value) => typeof value === 'string' ? value.toUpperCase() : '') - 所有过滤器都必须显式判断
value类型，尤其注意后端可能返回null、''、0或未定义字段
跨平台场景下 filter 实际未运行
在微信小程序、支付宝小程序等平台真机调试时，{{ value | myFilter }} 看似没报错，但结果没变化，接着在某个条件分支里触发 is not a function——这往往是因为小程序编译器压根没解析过滤器语法，而是把 myFilter 当普通变量去取值，结果是 undefined，后续又被当函数调用。
- 小程序平台（
mp-weixin、mp-alipay）不支持自定义filters，无论你注册得多规范，都不会执行 - H5 端能跑通不代表全端可用；一旦项目启用条件编译或运行在非 H5 环境，过滤器逻辑就失效
- 替代方案：改用计算属性（
computed）或方法（methods）封装转换逻辑，例如{{ toUpper(item.name) }}，并确保该方法在所有平台都可访问
Vue 版本混用导致 API 不存在
如果你升级过 uni-app 到 3.x（基于 Vue 3），Vue.filter 已被官方移除，此时调用会直接报 Vue.filter is not a function，而不是模板里报错。
- 检查
package.json中@dcloudio/uni-app版本：≥3.0.0-alpha即为 Vue 3 模式 - Vue 3 下不能再用
Vue.filter，也不能在模板中使用|语法；必须改用computed、method或自定义指令 - 不要试图兼容：Vue 2 的 filter 和 Vue 3 的响应式系统不互通，强行保留会导致部分平台白屏或静默失败
Vue.filter 注册位置完全正确，只要过滤器函数里没做 typeof value === 'string' 这类判断，遇到空数据就大概率在某个分支里触发 is not a function——而且错误堆栈往往不指向过滤器本身，排查成本很高。
