写前端时最烦的一种报错,不是拼写错,而是那句 is not a function:代码能跑起来,但在某个位置突然说某个东西不是函数。它通常不是语法问题,而是「你以为它是函数,运行时它其实是别的东西」。这篇不讲空概念,只给一套排查顺序:先看报错指到哪一行、再看这个东西是从哪来的、最后确认它运行时到底是什么类型,照着走就能定位大多数情况。
写前端最烦的报错之一,就是那句 is not a function:页面能加载、逻辑也走到那一步了,结果在某个位置突然告诉你,你正在调用的这个东西不是函数。它几乎不是语法问题,而是「你以为它是函数,运行时它其实是别的东西」。所以别盯着报错文字本身看,要看它指向哪一行、那个东西从哪来、运行时到底是什么类型。
这篇按三条线给一套能直接照做的排查顺序:先看调用点,再追来源,最后确认类型。绝大多数这类报错走完这三步就能定位,剩下的是个别库或框架造成的特殊情况。需要对照具体工具和方案时,可以到 /tools/speed-test 之类的站内页面看看当时的资料,但排查逻辑本身不依赖这些数字。
先说清这句话在说什么
这条报错的核心含义只有一句:代码在这个位置加了一对括号去调用,但运行时拿到的值不是函数类型,所以调用不了。它和「未定义」是两回事——未定义是找不到这个名字,而这个是名字找到了、值也在,只是类型不对。常见的值有 undefined、null,以及普通的对象、数组、字符串、数字。
| 运行时拿到的值 | 为什么会这样 | 典型来源 |
|---|---|---|
| undefined | 初始化还没跑完就被调用 | 模块加载顺序、条件分支 |
| null | 接口显式返回空或赋了空值 | 数据层没做兜底 |
| 普通对象 | 导出方式不匹配,拿到的是模块对象 | 命名导出与默认导出混用 |
| 数组 / 字符串 / 数字 | 取值路径错了,往下多取了一层 | 接口结构变化、字段改名 |
判断口径很简单:如果这一行前面几步都正常、只有调用这一步炸,基本可以锁定是「值来源」出了问题;不适用的情况是构建期就报错的语法问题,那属于另一类,跟这条运行时报错不是同一回事。
第一步:先盯住报错那一行
控制台会给出文件和行号,但要注意压缩或转译后的代码行号会偏,先看源码映射再看原始位置。把那一行的调用拆开:先只打印括号前面的那个值,不要急着加括号调用,看它到底打印出什么。很多时候一打印就明白了。
- 定位原始行在控制台点进报错堆栈,找到源码映射后的原始位置,确认是业务代码还是第三方代码。
- 拆开调用把 foo(a,b) 暂时改成先打印 foo,看它是函数、对象还是空值,先不触发调用。
- 往上游找赋值顺着这个变量找到它被赋值的地方,一层层往数据来源走,别停在报错行。
- 换固定值验证把这个变量临时换成固定函数,看还报不报,用来区分是数据问题还是逻辑问题。
排查顺序建议:报错行 → 该行用到的变量 → 该变量的赋值处 → 赋值处的数据来源。沿着这条链走,避免在错误的地方来回改。
第二步:看这个东西是从哪来的
来源通常只有三种:自己代码里的导入、别人给的模块、或者接口返回的数据。先查导入导出——命名导出和默认导出混用是最常见的一类,导入方拿到的其实是一个对象而不是函数,结果一调用就炸。
- 查命名导出与默认导出是否用混,导入方的花括号写法是不是对的
- 查模块加载顺序,被依赖的模块还没初始化完就调用,拿到的是空值,循环依赖里尤其多
- 查接口返回值,后端改了字段结构或少返回一层,前端就会拿一个对象去当函数调
- 查第三方库是否刚升级过,导出方式变了的话先怀疑它,而不是自己代码写错
不适用的情况:如果这个值来自第三方库且版本刚升过,先怀疑它的导出方式变了,而不是自己代码写错;反过来,如果是自己项目内部的模块,先查导入写法而不是先怪库。要对照工具目录时可以到 /tools/speed-test 看当时的收录情况,但判断顺序跟这些页面无关。
第三步:确认类型,再决定怎么修
在调用前打一行类型判断,把运行时真实类型打出来,比对着文档猜快得多。确认之后,修复分三类:值确实没准备好,就补初始化或加空值保护;导出方式不匹配,就改导入写法;接口结构变了,就改取值路径。
| 确认到的类型 | 优先修法 | 什么时候不适用 |
|---|---|---|
| undefined | 补初始化或加载顺序,加空值保护 | 模块本身就是异步可选的场景要单独设计 |
| 对象 | 改导入写法或取值路径 | 结构确实是对象而调用点是设计错误,要改设计 |
| null | 数据层兜底,别让它一路传到调用点 | 后端字段本来就允许为空,则应在展示层处理 |
| 其他类型 | 先定位值来源,再决定改哪一层 | 如果是第三方返回格式变化,升级或适配更稳妥 |
改完别只看这一处,搜一下同样的取值方式在项目里还用了几次,同一类错误往往成片出现。要核对当时的接口字段说明或库文档,可以到站内的资料库页面查,不要凭记忆改。
写代码时怎么少踩这类坑
减少这类报错,靠的不是记更多错误信息,而是把几件事变成团队约定:导入导出风格固定一种,别混着用;接口返回结构变化时,先在数据层做一次字段校验,别让非法结构一路传到调用点;给关键调用加类型标注或用类型检查工具,很多这种错在写的时候就能被拦下。
- 团队内导入导出风格统一,命名导出和默认导出别混着写
- 接口返回先校验再用,数据层挡一道,别把原始结构直接传下去
- 关键调用加类型标注或开启类型检查,把问题拦在运行前
- 排查不顺时先缩小范围,注掉调用换成固定值,区分数据问题和逻辑问题
is not a function 不是让你去读报错,而是让你去问一句:这个值,运行时到底是什么。下一步如果你正在选工具或对接口来源,可以到工具目录与资料库看当时的收录和字段说明,把排查结论对一遍再改代码。→
常见问题
is not a function 和 undefined 报错有什么区别?
undefined 报错通常是找不到这个名字,说明变量声明或导入环节就没成功;is not a function 是名字找到了、值也读到了,只是这个值不是函数类型,所以问题多半在赋值来源或导出方式上。排查方向不同,前者先看导入和声明,后者先看这个值运行时到底是什么。
明明本地能跑,上线才报这个错,为什么?
多半是环境差异导致的:本地和线上的依赖版本、构建配置、接口返回结构不一致,本地没走到那条分支所以看不出问题。做法是把线上报错行对应的变量值打出来,和本地对比,重点看导入方式和接口返回值这两处,差异一般都在这。
加个可选链是不是就修好了?
可选链只是让调用不成时直接跳过,不报错不等于逻辑对,该执行的动作没执行,后面可能出现更难查的空结果。它适合临时挡住崩溃,前提是你清楚这个值理论上应该存在;如果它本来就该有值却一直是空的,那还是要回到数据来源去解决。