Go應(yīng)用中優(yōu)雅處理Error的技巧總結(jié)

第Go應(yīng)用中優(yōu)雅處理Error的技巧總結(jié)前言

Go語(yǔ)言很強(qiáng)大并且現(xiàn)在也十分流行—許多項(xiàng)目都是用Go語(yǔ)言來(lái)實(shí)現(xiàn)的，如Kubernetes。Go語(yǔ)言的一個(gè)有趣特性是它的多值返回功能提供了一種與其他編程語(yǔ)言不同的錯(cuò)誤處理方法。Go將error視為具有預(yù)定義類型的值，其本身是一個(gè)interface類型。然而，編寫(xiě)多層體系結(jié)構(gòu)應(yīng)用程序并使用api暴露應(yīng)用的特性需要有包含更多上下文信息的error處理，而不僅僅是一個(gè)值。本文我們將探討如何封裝Go的error類型以在應(yīng)用程序中帶來(lái)更大的價(jià)值。

用戶自定義類型

我們將重寫(xiě)的Go里自帶的error類型，首先從一個(gè)自定義的錯(cuò)誤類型開(kāi)始，該錯(cuò)誤類型將在程序中識(shí)別為error類型。因此，我們引入一個(gè)封裝了Go的error的新自定義Error類型。

typeGoErrorstruct{

error

上下文數(shù)據(jù)

當(dāng)我們?cè)贕o中說(shuō)error是一個(gè)值時(shí)，它是字符串值-任何實(shí)現(xiàn)了Error()string函數(shù)的類型都可以視作error類型。將字符串值視為error會(huì)使跨層的error處理復(fù)雜化，因此處理error字符串信息并不是正確的方法。所以我們可以把字符串和錯(cuò)誤碼解耦：

typeGoErrorstruct{

error

Codestring

現(xiàn)在對(duì)error的處理將基于錯(cuò)誤碼Code字段而不是字符串。讓我們通過(guò)上下文數(shù)據(jù)進(jìn)一步對(duì)錯(cuò)誤字符串進(jìn)行解耦，在上下文數(shù)據(jù)中可以使用i18n包進(jìn)行國(guó)際化。

typeGoErrorstruct{

error

Codestring

Datamap[string]interface{}

Data包含用于構(gòu)造錯(cuò)誤字符串的上下文數(shù)據(jù)。錯(cuò)誤字符串可以通過(guò)數(shù)據(jù)模板化:

//i18Ndef

"InvalidParamValue":"Invalidparametervalue'{{.actual}}',expected'{{.expected}}'for'{{.name}}'"

在i18N定義文件中，錯(cuò)誤碼Code將會(huì)映射到使用Data構(gòu)建的模板化的錯(cuò)誤字符串中。

原因(Causes)

error可能發(fā)生在任何一層，有必要為每一層提供處理error的選項(xiàng)，并在不丟失原始error值的情況下進(jìn)一步使用附加的上下文信息對(duì)error進(jìn)行包裝。GoError結(jié)構(gòu)體可以用Causes進(jìn)一步封裝，用來(lái)保存整個(gè)錯(cuò)誤堆棧。

typeGoErrorstruct{

error

Codestring

Datamap[string]interface{}

Causes[]error

如果必須保存多個(gè)error數(shù)據(jù)，則causes是一個(gè)數(shù)組類型，并將其設(shè)置為基本error類型，以便在程序中包含該原因的第三方錯(cuò)誤。

組件(Component)

標(biāo)記層組件將有助于識(shí)別error發(fā)生在哪一層，并且可以避免不必要的errorwrap。例如，如果service類型的error組件發(fā)生在服務(wù)層，則可能不需要wraperror。檢查組件信息將有助于防止暴露給用戶不應(yīng)該通知的error，比如數(shù)據(jù)庫(kù)error：

typeGoErrorstruct{

error

Codestring

Datamap[string]interface{}

Causes[]error

ComponentErrComponent

typeErrComponentstring

const(

ErrServiceErrComponent="service"

ErrRepoErrComponent="repository"

ErrLibErrComponent="library"

響應(yīng)類型(ResponseType)

添加一個(gè)錯(cuò)誤響應(yīng)類型這樣可以支持error分類，以便于了解什么錯(cuò)誤類型。例如，可以根據(jù)響應(yīng)類型(如NotFound)對(duì)error進(jìn)行分類，像DbRecordNotFound、ResourceNotFound、UserNotFound等等的error都可以歸類為NotFounderror。這在多層應(yīng)用程序開(kāi)發(fā)過(guò)程中非常有用，而且是可選的封裝：

typeGoErrorstruct{

error

Codestring

Datamap[string]interface{}

Causes[]error

ComponentErrComponent

ResponseTypeResponseErrType

typeResponseErrTypestring

const(

BadRequestResponseErrType="BadRequest"

ForbiddenResponseErrType="Forbidden"

NotFoundResponseErrType="NotFound"

AlreadyExistsResponseErrType="AlreadyExists"

重試

在少數(shù)情況下，出現(xiàn)error會(huì)進(jìn)行重試。retry字段可以通過(guò)設(shè)置Retryable標(biāo)記來(lái)決定是否要進(jìn)行error重試:

typeGoErrorstruct{

error

Codestring

Messagestring

Datamap[string]interface{}

Causes[]error

ComponentErrComponent

ResponseTypeResponseErrType

Retryablebool

GoError接口

通過(guò)定義一個(gè)帶有GoError實(shí)現(xiàn)的顯式error接口，可以簡(jiǎn)化error檢查:

packagegoerr

typeErrorinterface{

error

Code()string

Message()string

Cause()error

Causes()[]error

Data()map[string]interface{}

String()string

ResponseErrType()ResponseErrType

SetResponseType(rResponseErrType)Error

Component()ErrComponent

SetComponent(cErrComponent)Error

Retryable()bool

SetRetryable()Error

抽象error

有了上述的封裝方式，更重要的是對(duì)error進(jìn)行抽象，將這些封裝保存在同一地方，并提供error函數(shù)的可重用性

funcResourceNotFound(id,kindstring,causeerror)GoError{

data:=map[string]interface{}{"kind":kind,"id":id}

returnGoError{

Code:"ResourceNotFound",

Data:data,

Causes:[]error{cause},

Component:ErrService,

ResponseType:NotFound,

Retryable:false,

這個(gè)error函數(shù)抽象了ResourceNotFound這個(gè)error，開(kāi)發(fā)者可以使用這個(gè)函數(shù)來(lái)返回error對(duì)象而不是每次創(chuàng)建一個(gè)新的對(duì)象：

//UserService

user,err:=u.repo.FindUser(ctx,userId)

iferr!=nil{

iferr.ResponseType==NotFound{

returnResourceNotFound(userUid,