前言
當(dāng)程序運(yùn)行過(guò)程中發(fā)生錯(cuò)誤的時(shí)候爽彤,Dart 會(huì)拋出異常推溃。在 Dart 中使用了on ... catch 方式來(lái)捕獲指定類型的異常昂利,例如:
class Person {
late String name;
late int age;
Person(this.name, this.age);
Person.fromJson(Map<String, dynamic> json) {
name = json['name'];
age = json['age'];
}
}
// 這里只是演示on...catch,實(shí)際上不應(yīng)該捕獲 Error
void main() {
try {
var person = Person.fromJson({'name': 'Jack'});
print(person);
} on TypeError catch (e, s) {
print('Error: $e, Stack: $s');
}
}
這種方式的好處就是能夠明確可能發(fā)生的錯(cuò)誤類型铁坎,做到精準(zhǔn)捕獲蜂奸,從而更容易定位問(wèn)題發(fā)生的原因。本篇來(lái)介紹 Dart 錯(cuò)誤和異常處理的規(guī)范硬萍。
規(guī)則1:盡可能地使用 on 語(yǔ)句
上面的例子扩所,其實(shí)我們寫(xiě)成下面的形式也能夠正常捕獲異常。
// 錯(cuò)誤示例
void main() {
try {
var person = Person.fromJson({'name': 'Jack'});
print(person);
} catch (e, s) {
print('Error: $e, Stack: $s');
}
}
這種方式稱之為“寶可夢(mèng)式異常處理”(Pokémon Exception Handling)朴乖。這樣一方面是對(duì)特定錯(cuò)誤做特定處理碌奉,例如 StackOverflowError
或 OutOfMemoryError
『或者是當(dāng)調(diào)用方法傳錯(cuò)參數(shù)后,準(zhǔn)確捕獲 ArgumentError
的話能夠幫助我們快速定位問(wèn)題嫉拐。
在大多數(shù)情況下哩都,應(yīng)該使用 on...catch 的方式來(lái)限制我們編程的時(shí)候的錯(cuò)誤類型,這樣會(huì)清楚地提醒我們有哪些可能的錯(cuò)誤婉徘,以及如何正確地處理它們漠嵌。
極少數(shù)情況下,可能會(huì)需要捕獲任何運(yùn)行時(shí)錯(cuò)誤盖呼。這對(duì)于框架設(shè)計(jì)或底層代碼為了避免應(yīng)用程序出現(xiàn)問(wèn)題來(lái)說(shuō)會(huì)有用儒鹿。即便是這樣,指定捕獲 Exception
也比捕獲全部類型要好几晤。Exception
是所有運(yùn)行時(shí)錯(cuò)誤的基類约炎,但不包括那些代碼中指明程序 bug 的錯(cuò)誤。
假設(shè)你真的需要捕獲某個(gè)代碼片段的所有異常的話,那么捕獲后應(yīng)該做一些處理圾浅,比如記錄運(yùn)行日志掠手,上報(bào)錯(cuò)誤,向用戶顯示錯(cuò)誤信息或重新拋出錯(cuò)誤狸捕,而不是靜默地處理掉 —— 那樣 bug 就也被靜默處理了喷鸽!
規(guī)則2:只對(duì)程序化錯(cuò)誤(bug)拋出 Error 的子類
Error
類是用于拋出程序化錯(cuò)誤的基類。當(dāng)一個(gè) Error
的對(duì)象或其子類對(duì)象拋出時(shí)灸拍,意味著代碼中存在 bug做祝。當(dāng)你的 API 想要告知調(diào)用者他的調(diào)用方式是錯(cuò)誤的時(shí)候,拋出一個(gè) Error
能夠清晰地告訴調(diào)用者錯(cuò)誤所在鸡岗。
相反地混槐,如果是一個(gè)運(yùn)行時(shí)錯(cuò)誤而不是代碼的 bug 的話,那樣拋出錯(cuò)誤其實(shí)是一個(gè)誤導(dǎo)纤房。這個(gè)時(shí)候纵隔,應(yīng)該拋出系統(tǒng)的異常類對(duì)象或其他類型對(duì)象。
規(guī)則3:不要直接捕獲 Error 或它的子類
這是因?yàn)?Error 代表的是代碼錯(cuò)誤炮姨,當(dāng)錯(cuò)誤發(fā)生的時(shí)候捌刮,我們應(yīng)該查看整個(gè)調(diào)用堆棧,暫停程序舒岸,然后打印堆棧信息來(lái)定位和修復(fù) bug绅作。如果捕獲這些錯(cuò)誤的話,會(huì)打斷進(jìn)執(zhí)行過(guò)程蛾派,隱藏 bug俄认。相比增加錯(cuò)誤處理代碼,更應(yīng)該做的是查看對(duì)應(yīng)代碼洪乍,并在錯(cuò)誤一開(kāi)始發(fā)生的地方修復(fù)它眯杏。
規(guī)則4:使用 rethrow 拋出捕獲的異常
如果要將捕獲的異常拋出,那么應(yīng)該優(yōu)先使用 rethrow
語(yǔ)句壳澳,而不是使用 throw
拋出同一個(gè)異常對(duì)象岂贩。這是因?yàn)?code>rethrow 會(huì)保留原異常的堆棧信息,而 throw 會(huì)重置堆棧信息到最近一個(gè)拋出點(diǎn)巷波。
// 正確示例
try {
somethingRisky();
} catch (e) {
if (!canHandle(e)) rethrow;
handle(e);
}
// 錯(cuò)誤示例
try {
somethingRisky();
} catch (e) {
if (!canHandle(e)) throw e;
handle(e);
}
異常(Exception)和錯(cuò)誤(Error)的區(qū)別
異常在 Dart 中是被認(rèn)為是常規(guī)的萎津,預(yù)期運(yùn)行過(guò)程中可能發(fā)生的,而且應(yīng)該被捕獲的問(wèn)題抹镊。也就是說(shuō)锉屈,這種問(wèn)題我們無(wú)法避免,舉個(gè)例子垮耳,網(wǎng)絡(luò)請(qǐng)求超時(shí)颈渊、數(shù)據(jù)不存在就屬于典型的異常,這個(gè)時(shí)候我們應(yīng)該捕獲這個(gè)異常,并且應(yīng)該提示用戶有用的信息儡炼,以引導(dǎo)用戶完成后續(xù)操作妓湘。
錯(cuò)誤在 Dart 中是意料之外的,不應(yīng)該被捕獲而應(yīng)該有程序員修復(fù)解決的問(wèn)題乌询。典型的例子包括了類型錯(cuò)誤(TypeError)榜贴,這個(gè)在接收后端參數(shù)時(shí)經(jīng)常發(fā)生,比如Dart 定義的是整型妹田,結(jié)果后端返回的是字符串就會(huì)報(bào)下面的錯(cuò)誤:
type 'String' is not a subtype of type 'int'
這種就屬于程序員制造的 bug唬党,應(yīng)該有由程序員搞定,而不是通過(guò)異常捕獲解決鬼佣。
總結(jié)
Dart 對(duì)程序運(yùn)行問(wèn)題做了兩種區(qū)分驶拱,一種是非人為,運(yùn)行過(guò)程可能發(fā)生的問(wèn)題晶衷,即 Exception蓝纲;另一種是人為的,不應(yīng)該發(fā)生的問(wèn)題晌纫,即 Error税迷。這兩種處理方式是不同的,錯(cuò)誤不應(yīng)該捕獲锹漱,而應(yīng)該暴露出來(lái)以便修復(fù)箭养。同時(shí),捕獲異常的時(shí)候最好是使用 on...catch 形式哥牍,以便清晰地知道有哪些異常毕泌,以及如何處理。對(duì)于需要重新拋出異常嗅辣,應(yīng)該優(yōu)先使用 rethrow 來(lái)操作以保持堆棧信息撼泛。