is not a function是什么错

入门与上手

讲清 is not a function 报错到底在说什么,按调用点、来源、类型三条线快速定位,并给出可直接照做的修复与自查清单。

写前端时最烦的一种报错,不是拼写错,而是那句 is not a function:代码能跑起来,但在某个位置突然说某个东西不是函数。它通常不是语法问题,而是「你以为它是函数,运行时它其实是别的东西」。这篇不讲空概念,只给一套排查顺序:先看报错指到哪一行、再看这个东西是从哪来的、最后确认它运行时到底是什么类型,照着走就能定位大多数情况。

写前端最烦的报错之一,就是那句 is not a function:页面能加载、逻辑也走到那一步了,结果在某个位置突然告诉你,你正在调用的这个东西不是函数。它几乎不是语法问题,而是「你以为它是函数,运行时它其实是别的东西」。所以别盯着报错文字本身看,要看它指向哪一行、那个东西从哪来、运行时到底是什么类型。

这篇按三条线给一套能直接照做的排查顺序:先看调用点,再追来源,最后确认类型。绝大多数这类报错走完这三步就能定位,剩下的是个别库或框架造成的特殊情况。需要对照具体工具和方案时,可以到 /tools/speed-test 之类的站内页面看看当时的资料,但排查逻辑本身不依赖这些数字。

先说清这句话在说什么

这条报错的核心含义只有一句:代码在这个位置加了一对括号去调用,但运行时拿到的值不是函数类型,所以调用不了。它和「未定义」是两回事——未定义是找不到这个名字,而这个是名字找到了、值也在,只是类型不对。常见的值有 undefined、null,以及普通的对象、数组、字符串、数字。

运行时拿到的值为什么会这样典型来源
undefined初始化还没跑完就被调用模块加载顺序、条件分支
null接口显式返回空或赋了空值数据层没做兜底
普通对象导出方式不匹配,拿到的是模块对象命名导出与默认导出混用
数组 / 字符串 / 数字取值路径错了,往下多取了一层接口结构变化、字段改名

判断口径很简单:如果这一行前面几步都正常、只有调用这一步炸,基本可以锁定是「值来源」出了问题;不适用的情况是构建期就报错的语法问题,那属于另一类,跟这条运行时报错不是同一回事。

第一步:先盯住报错那一行

控制台会给出文件和行号,但要注意压缩或转译后的代码行号会偏,先看源码映射再看原始位置。把那一行的调用拆开:先只打印括号前面的那个值,不要急着加括号调用,看它到底打印出什么。很多时候一打印就明白了。

  1. 定位原始行在控制台点进报错堆栈,找到源码映射后的原始位置,确认是业务代码还是第三方代码。
  2. 拆开调用把 foo(a,b) 暂时改成先打印 foo,看它是函数、对象还是空值,先不触发调用。
  3. 往上游找赋值顺着这个变量找到它被赋值的地方,一层层往数据来源走,别停在报错行。
  4. 换固定值验证把这个变量临时换成固定函数,看还报不报,用来区分是数据问题还是逻辑问题。

排查顺序建议:报错行 → 该行用到的变量 → 该变量的赋值处 → 赋值处的数据来源。沿着这条链走,避免在错误的地方来回改。

第二步:看这个东西是从哪来的

来源通常只有三种:自己代码里的导入、别人给的模块、或者接口返回的数据。先查导入导出——命名导出和默认导出混用是最常见的一类,导入方拿到的其实是一个对象而不是函数,结果一调用就炸。

  • 查命名导出与默认导出是否用混,导入方的花括号写法是不是对的
  • 查模块加载顺序,被依赖的模块还没初始化完就调用,拿到的是空值,循环依赖里尤其多
  • 查接口返回值,后端改了字段结构或少返回一层,前端就会拿一个对象去当函数调
  • 查第三方库是否刚升级过,导出方式变了的话先怀疑它,而不是自己代码写错

不适用的情况:如果这个值来自第三方库且版本刚升过,先怀疑它的导出方式变了,而不是自己代码写错;反过来,如果是自己项目内部的模块,先查导入写法而不是先怪库。要对照工具目录时可以到 /tools/speed-test 看当时的收录情况,但判断顺序跟这些页面无关。

第三步:确认类型,再决定怎么修

在调用前打一行类型判断,把运行时真实类型打出来,比对着文档猜快得多。确认之后,修复分三类:值确实没准备好,就补初始化或加空值保护;导出方式不匹配,就改导入写法;接口结构变了,就改取值路径。

确认到的类型优先修法什么时候不适用
undefined补初始化或加载顺序,加空值保护模块本身就是异步可选的场景要单独设计
对象改导入写法或取值路径结构确实是对象而调用点是设计错误,要改设计
null数据层兜底,别让它一路传到调用点后端字段本来就允许为空,则应在展示层处理
其他类型先定位值来源,再决定改哪一层如果是第三方返回格式变化,升级或适配更稳妥

改完别只看这一处,搜一下同样的取值方式在项目里还用了几次,同一类错误往往成片出现。要核对当时的接口字段说明或库文档,可以到站内的资料库页面查,不要凭记忆改。

写代码时怎么少踩这类坑

减少这类报错,靠的不是记更多错误信息,而是把几件事变成团队约定:导入导出风格固定一种,别混着用;接口返回结构变化时,先在数据层做一次字段校验,别让非法结构一路传到调用点;给关键调用加类型标注或用类型检查工具,很多这种错在写的时候就能被拦下。

  • 团队内导入导出风格统一,命名导出和默认导出别混着写
  • 接口返回先校验再用,数据层挡一道,别把原始结构直接传下去
  • 关键调用加类型标注或开启类型检查,把问题拦在运行前
  • 排查不顺时先缩小范围,注掉调用换成固定值,区分数据问题和逻辑问题
is not a function 不是让你去读报错,而是让你去问一句:这个值,运行时到底是什么。
下一步如果你正在选工具或对接口来源,可以到工具目录与资料库看当时的收录和字段说明,把排查结论对一遍再改代码。

常见问题

is not a function 和 undefined 报错有什么区别?

undefined 报错通常是找不到这个名字,说明变量声明或导入环节就没成功;is not a function 是名字找到了、值也读到了,只是这个值不是函数类型,所以问题多半在赋值来源或导出方式上。排查方向不同,前者先看导入和声明,后者先看这个值运行时到底是什么。

明明本地能跑,上线才报这个错,为什么?

多半是环境差异导致的:本地和线上的依赖版本、构建配置、接口返回结构不一致,本地没走到那条分支所以看不出问题。做法是把线上报错行对应的变量值打出来,和本地对比,重点看导入方式和接口返回值这两处,差异一般都在这。

加个可选链是不是就修好了?

可选链只是让调用不成时直接跳过,不报错不等于逻辑对,该执行的动作没执行,后面可能出现更难查的空结果。它适合临时挡住崩溃,前提是你清楚这个值理论上应该存在;如果它本来就该有值却一直是空的,那还是要回到数据来源去解决。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。