报错别靠猜:try...catch 与 Error 实战指南
坏数据让页面崩了、没判空的属性炸了、回调里抛出的错外面的 try 接不住。本文按 MDN 的 try...catch、Error 与 throw 官方文档讲清楚:报错的三种、try 的三种写法、finally 的规矩、嵌套与重抛、instanceof 分流、Error 一家子、cause 与回调陷阱。

先把这篇的边界说清楚。站里已经有《你的代码到底什么时候跑?JavaScript 事件循环实战指南》,讲的是代码什么时候执行;还有《别再让异步代码悄悄翻车:Promise 与 async/await 实战指南》,讲的是异步怎么写;还有《上线第一天用户白屏了你却最后一个知道:vibe 项目的错误监控与崩溃上报实战》,讲的是上线之后怎么发现错误。这篇不讲执行时序、不讲异步写法、不讲上线监控,只讲一件事:一段同步代码跑着跑着出错了,你怎么接住它、认清它、再决定是处理还是放手。下面用到的“青石咖啡馆”还是那个虚构的练手项目:一个帮街边咖啡馆做点单的网页小工具。这回讲的是它的点单页怎么处理报错:菜单数据读坏了、顾客信息缺了一块、订单提交到一半断了。本文所有以它为例的操作、代码和数字,都是为了讲清楚做法编出来的,不是真实记录。所有关于报错的语法和行为,都来自 MDN 的《try...catch》《Error》《throw》三篇官方文档,来源见每篇的 meta 信息与 evidence 记录。文档里的例子,比如打开文件再关上、把订单排个序、读文件回调,都是文档自带的示例,不是真实服务。读完这篇,你应该能做到三件事:看到报错先认出它是哪一种、该接的接住、该放的放手;写得出 catch 里的分流和重抛,而不是一把 catch 住所有错;遇到回调里冒出来的错,知道为什么外面的 try 接不住、该换成什么写法。
第一步:报错先分三种,try 只能接住其中一种
新手最容易犯的错,是以为 try...catch 能接住一切错。其实报错分三种,try 只能接住中间那一种。第一种是语法错:文件本身写错了,比如少了个括号、关键字拼错了,代码在解析阶段就挂了,根本没开始跑,try 包在外面也没用,因为 try 自己也在那份写错了的文件里。第二种是运行时错:代码写得没问题,跑到某一行才炸,比如读了一个不存在的变量、调了一个不存在的函数、把坏数据传给了 JSON.parse,这种错 try 能接住。第三种是逻辑错:代码一口气跑完,一个错也没报,但结果是错的,比如订单总价算成了负数、菜单少了一道菜,这种错 try 接不到,只能靠测试、靠检查、靠把关键数字打印出来看。青石咖啡馆的点单页三种都出过:有一次是 HTML 里引用的脚本文件本身少了个花括号,页面直接白屏,try 包了也没用;更多时候是运行时错,try 接住了;最难查的是逻辑错,总价算错了但页面看着一切正常。记住第一句话:先问“这错是哪一种”,再决定 try 有没有用。
第二步:try 有三种写法,catch 和 finally 至少得有一个
try 语句永远以一个 try 块开头,后面必须跟一个 catch 块或者一个 finally 块,也可以两个都有,于是就有了三种形态:try...catch、try...finally、try...catch...finally。MDN 特别提醒了一句:跟 if、for 不一样,try、catch、finally 后面必须是块,也就是花括号包起来的代码,不能只跟一条语句。写 try doSomething() 这样的一行,本身就是个 SyntaxError。try 块里放的是要执行的语句;catch 块里放的是 try 块里抛错之后要执行的语句;finally 块里放的是不管出没出错、控制流离开之前都要执行的语句。咖啡馆的点单页在“提交订单”上用的是 try...catch...finally:try 里发请求、catch 里告诉顾客“提交失败、再试一次”、finally 里把“提交中”的按钮恢复成可点。记住判断句:try 后面不能空着,catch 和 finally 至少留一个。
第三步:出错立刻跳 catch,不出错 catch 一眼都不看
控制流的规则很简单。try 块里任何一条语句抛了错,或者 try 块里调的函数抛了错,控制流立刻转到 catch 块,没跑完的 try 块剩下的语句直接跳过;如果 try 块一路跑完没抛错,catch 块整个被跳过,一眼都不看。finally 块则是不管怎样都会在控制流离开之前跑一遍:try 块跑完了跑,catch 块跑完了也跑,抛了错没人接也跑。MDN 的文件例子讲的就是这个用法:先打开文件,再在 try 里写文件,最后在 finally 里关文件,不管写文件那步成没成,文件一定会被关上。咖啡馆的点单页在“打开点单抽屉”上就是这么写的:try 里算总价、渲染订单,catch 里显示“算不出来了”,finally 里把加载中的转圈关掉。记住判断句:catch 只在出错时跑,finally 永远跑。
第四步:catch 里的 e 是什么、能活多久
catch 后面括号里那个 e,就是被抛出来的那个值,MDN 叫它 exceptionVar。e 身上有三样东西最常用:name 是错的类型名,比如 TypeError、SyntaxError;message 是人能读懂的一句话,比如 oops、Parameter is not a number;stack 是出错时的调用栈,各家浏览器的格式不太一样,但都有。e 只在 catch 块的作用域里活着,出了 catch 就拿不到它了。e 不一定非得是个标识符,MDN 说可以用解构一次拿好几个:catch ({ name, message }),直接把名字和消息拆出来。但要小心,解构出来的名字和 catch 块里声明的变量不能重名,否则直接报 SyntaxError。还有一个省事的写法:如果 catch 块里根本用不到这个错,连 e 和括号都可以一起省略,写成 catch {,MDN 的 isValidJSON 例子就是这么写的:try 里 JSON.parse(text),成了返回 true,败了直接返回 false,错本身看都不看。记住判断句:要认错,看 e 的 name 和 message;不用认错,连括号都可以省。
第五步:抛出来的不一定是 Error,接住先规范化
throw 后面能跟任何表达式,抛字符串、抛数字、抛对象都合法。MDN 的原话是,实际抛出来的东西应该永远是 Error 对象或者它的子类,比如 TypeError、RangeError,因为接错的代码会默认被接住的东西身上有 message 这类属性,抛个裸字符串过去,接的人一读 message 就读了个 undefined。更稳妥的做法是在 catch 里先规范化:if (!(e instanceof Error)) { e = new Error(e); },把不是 Error 的值包成 Error 再往下处理。咖啡馆的点单页就吃过这个亏:早期有个地方 throw "菜单读不出来",catch 里写的是 console.error(e.message),结果控制台只打出 undefined,真正的原因反而看不见了。改成一律 throw new Error("菜单读不出来"),catch 里再读 message,原因才老老实实出现在日志里。记住判断句:抛错只抛 Error,接错先把不是 Error 的包成 Error。
第六步:finally 里别写 return 和 throw,它们会盖掉前面的结果
finally 有一条最容易踩的规矩。try 块或者 catch 块里写了 return、throw、break、continue,效果会被推迟到 finally 块跑完之后再生效;返回值表达式本身是在进 finally 之前就求好了值的。MDN 的 safeWriteMyFile 例子就是这样:try 里 return writeMyFile(theData),先把要返回的值算好,再进 finally 关文件,关完了才真正返回。但如果 finally 块里自己又写了一条控制流语句,它会把前面那条盖掉,而且不带任何商量。MDN 的 doIt 例子很直观:try 里往数组里推了 try、排了序、准备返回排好的数组,finally 里又推了 finally、还 return 了数组,结果返回的是 try、z、finally 三个元素,而不是 try 里准备好的那两个。更狠的例子是:try 里 throw "try",catch 里 throw "catch",finally 里 return "finally",最后函数返回的是 finally,连错都没抛出来。MDN 的结论写得很直白:在 finally 块里用控制流语句一般是个坏主意,因为它会盖掉前面已经执行过的控制流语句的效果,这几乎从来不是你想要的。记住判断句:finally 只写清理代码,不写 return,不写 throw。
第七步:try 可以嵌套,错只会被最近的 catch 接一次
try 语句可以一层套一层。如果内层的 try 没有 catch,只有 finally,那么内层抛出来的错会交给外层的 catch 来接。MDN 的嵌套例子把顺序写得很清楚:内层 try 里 throw new Error("oops"),内层只有 finally,打印 finally,然后外层 catch 接住,打印 outer 加上 oops;如果内层自己也有 catch,内层先接住打印 inner 加 oops,再跑 finally,外层 catch 就接不到了,除非内层 catch 里再把错抛出去。任何一个错只会被最近的那个 catch 接一次,除非你主动重抛。重抛就是在 catch 里再写 throw e,把原样不动的错往上抛,让外层决定怎么办。咖啡馆的点单页在“读取本地保存的订单”上就是这么分的:内层 catch 只处理“本地数据坏了”这一种情况,修不好就重抛,外层 catch 再统一告诉顾客“订单恢复失败”。记住判断句:内层能处理就处理,处理不了就重抛,别在内层把错悄悄吞了。
第八步:没有按类型 catch 的语法,用 instanceof 自己分流
Java 里可以写 catch (RangeError e) 这样的按类型 catch,JavaScript 里没有。MDN 说,要实现“条件 catch”,得在 catch 块里用 if、else if、else 自己分流:e instanceof TypeError 就这么办,e instanceof RangeError 就那么办,最后 else 里把没认出来的错重抛。常见的用法是只接住一小撮预期的错,别的统统重抛,比如 MDN 的例子:只有 RangeError 才在原地处理,别的错一律 throw e。Error 页的例子也是这个路子:先按 EvalError、RangeError 一个个认,认不上的在最后的 else 里 throw e,让它继续往上走。咖啡馆的点单页在“解析顾客填的备注”上就是这么写的:JSON.parse 抛出的 SyntaxError 在原地处理成“备注格式不对、请重新填”,别的错一律重抛。记住判断句:JavaScript 没有按类型 catch,分流靠 instanceof,认不出的要重抛。
第九步:throw 是你主动报错的工具,只抛 Error 才算数
throw 语句的写法只有一行:throw 加一个表达式。它的执行会在调用栈里一路穿上去,直到被某个 catch 接住。MDN 的 getRectArea 例子讲的是最常见的用法:参数不是数字就 throw new Error("Parameter is not a number!"),外面的 try...catch 接住,打印 Error 加上这句话。MDN 的 sum 例子讲的是按类型抛:参数里混进了字符串,就 throw new TypeError("Can only add numbers"),因为错的类型本身就是一种信息,接的人一看 TypeError 就知道是类型不对。还有一条语法上的坑:throw 和它后面的表达式之间不能换行,换了行会被自动分号插入机制切成 throw; 再加一个 new Error(),而 throw 后面必须跟表达式,写成这样就是无效代码。MDN 给的绕法是把表达式用括号包起来再换行。记住判断句:主动报错用 throw,抛的一定是 Error,throw 后面别换行。
第十步:Error 一家子各管一摊,认名字就知道错在哪
除了通用的 Error,JavaScript 还有一家人,各管一摊。TypeError 是变量或参数的类型不对,比如把字符串当数字加、读了 null 身上的属性;ReferenceError 是引用了一个无效的引用,比如用了没声明过的变量名;RangeError 是数字变量或参数超出了有效范围;SyntaxError 是语法错,JSON.parse 收到一串坏数据时抛的就是它;URIError 是 encodeURI 或者 decodeURI 收到了无效参数;EvalError 是跟全局函数 eval 有关的错;AggregateError 是把多个错包成一个错,比如 Promise.any 要汇报多个失败时用它;InternalError 是引擎内部的错,比如递归太深。MDN 的 try...catch 首页例子就是最好的起点:try 里调了一个不存在的函数 nonExistentFunction,抛出来的是 ReferenceError,名字里就写着“引用错了”。咖啡馆的点单页对得上号的三类最常见:JSON.parse 坏数据是 SyntaxError,读了没登录顾客的地址是 TypeError,拼错了变量名是 ReferenceError。记住判断句:先看 name 再看 message,名字就是错的分类。
第十一步:给错留个 cause,甩锅的时候有证据链
有时候一个地方会因为好几个原因失败,失败的样子还差不多,分不清是谁的错。MDN 的办法是抓住底层的错,再抛一个新的、更具体的错,同时把原来的错塞进新错的 cause 里:throw new Error("Failed in some way", { cause: err })。这样上层 catch 到新错,还能顺着 err.cause 找到原来的错和原来的调用栈。MDN 特别提醒:如果你在写库,宁可让使用者靠 cause 来分辨不同的错,也别让他们去解析 message 里的文字,因为文字一改,分辨的代码就全断了。自定义的错类型也一样:class MyError extends Error,构造器里把 options 原样传给 super(message, options),cause 才能装进去。咖啡馆的点单页在“提交订单”上就是这么做的:底层可能是网络断了、也可能是菜单数据坏了,catch 里一律包成 new Error("提交订单失败", { cause: err }) 再往上抛,上层只看 message 就知道是哪一步失败了,想深挖再顺着 cause 往下找。记住判断句:别靠解析 message 分辨错,用 cause 留证据链。
第十二步:回调里 throw 的错,外面的 try 接不住
这是新手最容易懵的一点:try...catch 只能接住同一段同步执行里的错。MDN 的 throw 页讲了一个回调的例子:readFile("foo.txt", (err, data) => { if (err) { throw err; } }),这个 throw 跑在回调函数里,等回调跑起来的时候,外面的 try 早就跑完了,所以这个错没人接,程序会直接崩掉,除非 readFile 自己在内部接住了它,或者程序跑在一个能接住顶层错的环境里。MDN 给的正解是把回调包成 Promise:readFilePromise 里收到 err 就 reject(err),外面用 await 等它,再用 try...catch 接住。异步的写法细节在站里的《别再让异步代码悄悄翻车:Promise 与 async/await 实战指南》里讲全了,这里只记住边界:同步代码用 try...catch,异步代码先变成 Promise 再用 try...catch,别把 throw 写进回调里指望外面的 try 来接。咖啡馆的点单页早期有个定时器回调里 throw 的错,就是这么漏网的:定时器一到点就崩,try 包在外面一点用都没有。记住判断句:回调里的 throw,try 接不住,先包成 Promise 再接。
第十三步:别乱 catch,空 catch 是把 bug 藏起来
最后一条是判断,不是语法。catch 的意思是“我知道这个错可能出、也知道出了之后该怎么办”,比如 JSON.parse 坏了就提示重新填、本地数据坏了就清空重建。空的 catch 块,或者 catch 住所有错然后什么都不干,是最糟糕的写法:错确实不报了,但功能也悄悄坏了,顾客点单没反应、订单没保存,你连日志里都找不到原因。MDN 的条件 catch 例子反过来就是这条的正面教材:只接住预期的一小撮错,别的统统重抛,让它炸出来、让人看见、让人修掉。咖啡馆的点单页有条硬规矩:catch 里要么给顾客一个能看懂的提示,要么把错记下来,要么重抛,三件事至少做一件;什么都不做的 catch,评审时直接打回。记住判断句:不知道怎么处理,就别 catch;接住了不处理,等于把错藏起来。
检查清单:写完 try...catch,对着这张表过一遍
下图是虚构的青石咖啡馆点单页一个月里 90 次报错的原因分布:JSON.parse 收到坏数据、SyntaxError 26 次(28.9%);读了 null 或者 undefined 身上的属性、TypeError 22 次(24.4%);拼错了变量名、ReferenceError 14 次(15.6%);空 catch 把错吞了、找不到原因 12 次(13.3%);回调里 throw 的错没人接 9 次(10.0%);finally 里写了 return、盖掉了前面的结果 7 次(7.8%)。26 + 22 + 14 + 12 + 9 + 7 = 90,百分比合计 100.0%。数字是编的例子,道理是真的:排前三的都是“错认不清、接不住”,而不是“错太难修”。写完自己的 try...catch,对着下面这张表过一遍:这错是语法错、运行时错还是逻辑错,try 有没有用;try 后面跟了 catch 还是 finally,有没有落空;catch 里认的是 name 还是 message,有没有把非 Error 的值规范化;finally 里只写了清理、没写 return 和 throw;嵌套的 try 有没有把处理不了的错重抛;分流靠的是 instanceof、认不出的有没有重抛;主动抛的错是不是 Error、throw 后面有没有换行;cause 有没有留、自定义错有没有把 options 传给 super;回调里的 throw 有没有先包成 Promise;catch 里有没有至少做一件事:提示、记日志、重抛。十条都过了,这段报错处理才算写完了。
评论 (0)
原始来源
相关文章
函数你每天都在调,这篇把你一直在做的事讲清楚。本文按 MDN 的《Functions》《Arrow function expressions》《Rest parameters》三篇官方文档讲清楚:声明与表达式、参数与实参、默认值、剩余参数、展开语法、返回值、箭头函数省写规则、this 的坑、回调与高阶函数、作用域。
同一个页面要在手机、平板、电脑上都站得住。本文按 MDN 的《Responsive web design》《Using media queries》《viewport meta 参考》三篇官方文档讲清楚:流式 HTML、viewport 标签、流式网格与 max-width、图片不撑破容器、媒体查询语法、按内容定断点、mobile-first、响应式字号、按能力查设备与上线检查清单。
JavaScript 里数字只有一种类型 Number,存成 64 位浮点数,所以 0.1 + 0.2 等于 0.30000000000000004。本文按 MDN 的《Basic math in JavaScript》《Math》《Number》三篇官方文档讲清楚:一种数字类型、浮点误差、钱改成分算、字符串转数字、NaN 与 Infinity、安全整数、四种取整、Math.random、Math 工具箱与显示格式化。