Go 開發(fā)踩過的那些坑,你踩過幾個(gè)?
一些基礎(chǔ)
Java 枚舉轉(zhuǎn)成 Go
Java
public enum DetectionMethodEnum {
PROCESS_HASH("process_hash", "進(jìn)程Hash檢測(cè)"),
private final String type;
private final String desc;
}
Go:
type DetectionMethod string
type DetectionMethodInfo struct {
MethodType string
Desc string
}
const (
ProcessHash DetectionMethod = "PROCESS_HASH"
)
var DetectionMethodMap = map[DetectionMethod]DetectionMethodInfo{
ProcessHash: {
MethodType: "process_hash",
Desc: "進(jìn)程Hash檢測(cè)"
}
}map 訪問
Java:
map.get(key) or map.getOrDefault(key, defaultValue)
Go:
if value, ok := map[key] ; ok {
// ...code
}強(qiáng)制類型轉(zhuǎn)換
注意,轉(zhuǎn)換為 *Struct 和 轉(zhuǎn)換為 Struct 并不等同。如果你的值是指針,那么轉(zhuǎn)換為結(jié)構(gòu)體會(huì)報(bào)錯(cuò);反之亦然。
Java:
if (detectResultBase instanceof MemBackdoorDetectResult) {
MemBackdoorDetectResult detectResult = (MemBackdoorDetectResult) detectResultBase;
// ...code
}
Go
if memBackdoorDetectResult, ok := detectResultBase.(*result.MemBackdoorDetectResult) ; ok {
// ...code
}空指針引用
Java 的 NullPointerException 在 Go 變成了 nil pointer reference。
有兩個(gè)小區(qū)別:
- 對(duì) nil 進(jìn)行 foreach , java 會(huì)報(bào) NPE ,但是 Go 不會(huì);
- 對(duì) nil 調(diào)用方法,java 會(huì)報(bào) NPE, 但 Go 不會(huì)。
給定代碼如下:
- range arr 時(shí),Go 不會(huì)拋錯(cuò),java 會(huì);
- Go 能夠調(diào)用 SayHello 方法,調(diào)用 GetName() 時(shí),在 return s.Name 報(bào)錯(cuò)了,而不是在 GetName 的調(diào)用行數(shù)報(bào)錯(cuò)。說明它走到方法里面了。問了下通義千問,大意是,方法并不屬于對(duì)象的內(nèi)部數(shù)據(jù)結(jié)構(gòu),因此對(duì) nil 訪問方法會(huì)轉(zhuǎn)到該結(jié)構(gòu)體的方法表,但如果訪問 nil 的內(nèi)部數(shù)據(jù)結(jié)構(gòu),則一定會(huì)拋 nil pointer reference
func TestBasic(t *testing.T) {
var arr []int = nil
for i := range arr {
fmt.Println(i)
}
var stu *Stu
stu.SayHello()
fmt.Println(stu.GetName())
}
type Stu struct {
Name string
}
func (s *Stu) SayHello() {
fmt.Println("hello")
}
func (s *Stu) GetName() string {
return s.Name
}
圖片
圖片
錯(cuò)誤處理
Go 的錯(cuò)誤處理與 Java 也有較大區(qū)別。
- Go 通過返回和判斷單獨(dú)的 error 來進(jìn)行錯(cuò)誤,應(yīng)用必須對(duì)錯(cuò)誤處理。如果忽略錯(cuò)誤,則程序會(huì)繼續(xù)往下走,直到走完流程,或者在其它地方遇到 panic 而終止。如果忽略錯(cuò)誤(可使用 _ 表示),且沒有日志(類似 Java catch 了但是什么都不做),則程序什么都不輸出。就好像突然在哪里斷掉了,但是你沒法知道在哪里斷掉了。問題排查會(huì)很蛋疼且耗時(shí)。
- Java 如果遇到運(yùn)行時(shí)異常,會(huì)自動(dòng)往上拋,遇到捕獲的就按照指定程序處理,沒有捕獲的繼續(xù)往上拋。如果沒有任何處理,則最終會(huì)拋出異常。如果捕獲了異常卻不處理,也會(huì)什么都不輸出,當(dāng)然,這是自找罪受。
換句話說,Go 的錯(cuò)誤如果忽略又不打日志,程序就會(huì)毫無輸出,對(duì)排查很不方便。這意味著:Go 做處理處理會(huì)比較繁瑣,每一個(gè)方法如果有錯(cuò)誤就應(yīng)該拋出,每一個(gè)錯(cuò)誤都必須決定是否處理,還是繼續(xù)往上拋。益處是:能夠培養(yǎng)縝密的錯(cuò)誤處理習(xí)慣。像 Java 那樣隨意,肯定會(huì)遭到懲罰。
Go 錯(cuò)誤處理的一些推薦做法:
- 前端錯(cuò)誤,打印請(qǐng)求參數(shù)(為空可以不打),在 error 里返回錯(cuò)誤碼和錯(cuò)誤信息【強(qiáng)制】。
- 存儲(chǔ)層方法,比如 repository ,必須返回 errror ,方便上層根據(jù)錯(cuò)誤處理【強(qiáng)制】。
- 檢測(cè)流程,創(chuàng)建出錯(cuò),直接終止流程,并返回 Error【強(qiáng)制】。
- API (庫方法、數(shù)據(jù)庫、中間件、外部接口等)返回的錯(cuò)誤必須捕獲處理,否則程序會(huì)無聲息終止【強(qiáng)制】。
- 非數(shù)據(jù)庫錯(cuò)誤,如果有錯(cuò)誤碼的,返回錯(cuò)誤碼和錯(cuò)誤信息;沒有錯(cuò)誤碼的,默認(rèn)返回 InternalError 或 SystemError【推薦】。
- 編寫工具類方法,推薦返回 error 【推薦】。
- 上層方法,根據(jù)情形處理:如果不影響流程(局部失敗不影響整體失敗的情形),則打印錯(cuò)誤日志,然后繼續(xù)往下走;如果影響流程,直接終止流程,拋出 error 。
Go 報(bào)錯(cuò)
不得不說, Go 的報(bào)錯(cuò)真的是有點(diǎn)不知所云。咋一看,看半天都看不出什么問題,真是費(fèi)眼睛!因此,我總結(jié)了些常見報(bào)錯(cuò)類型,方便以后更快排查。
重名類
可能是有兩個(gè)重名類 DO。比如有兩個(gè)同名類 A 和 B,本來應(yīng)當(dāng)引用 A,結(jié)果引用了 B。
Cannot use 'oldModels' (type []"xxx/internal/common/dal/service".T) as the type []"github.com/samber/lo".T
變量 models 與包名沖突
有時(shí),你會(huì)發(fā)現(xiàn)包里確實(shí)聲明了這個(gè)變量、實(shí)例或結(jié)構(gòu)體,但 IDE 就是報(bào)錯(cuò),找不到。很可能方法里的局部變量與包名沖突了。如下所示,有一個(gè)包名 models,又聲明了一個(gè) models 變量,當(dāng)然找不到啦!這種問題肉眼很難察覺。就像 Javascript 里,前面聲明了一個(gè) password 變量,后面不小心寫成了 passord ,javascript 是不會(huì)報(bào)錯(cuò)的(現(xiàn)在不知道會(huì)不會(huì),好久沒寫 js 了)。
圖片
反序列化錯(cuò)誤
reason 字段的上報(bào)數(shù)據(jù)與類型定義不一致。
圖片
存在包已經(jīng)被刪除但引用沒有刪除
通常是因?yàn)橹霸谀硞€(gè)類里引用了某個(gè)包,后面又刪除了這個(gè)包,或者更改了包的位置導(dǎo)致。
圖片
循環(huán)包引用
在 ”Go 包循環(huán)引用及對(duì)策[1] “ 一文里已經(jīng)有講解過。
方法簽名不一致
類似問題可能是方法簽名不一致,比如方法函數(shù)簽名有返回值而實(shí)際傳入函數(shù)無返回值
cannot use calc (variable of type func()) as async.Consumer value in argument to taskExecutor.SubmitTask
函數(shù)參數(shù)沒有命名,只有類型
Function has both named and unnamed parameters '(ctx context.Context, []D)'
圖片
方法實(shí)現(xiàn)不對(duì)
Go 沒有支持 lambda 表達(dá)式。寫慣了 Java 導(dǎo)致。
報(bào)錯(cuò):Invalid operation: func(key string) (*models.WhiteRuleDO,error) - (the operator - is not defined on func(key string) (*models.WhiteRuleDO, error))
Cannot use 'func(key string) (*models.WhiteRuleDO,error) ->' (type bool) as the type func(key string) (T, error)
圖片
返回類型不一致
return whiteRulesInner, nil 處 報(bào)錯(cuò):Cannot use 'whiteRulesInner' (type []T) as the type *models.WhiteRuleDO
實(shí)際上 h.beyondLoginWhiteRuleCache.GetWithLoader 要返回的是 []*models.WhiteRuleDO 而不是 *models.WhiteRuleDO。
whiteRules, err := h.beyondLoginWhiteRuleCache.GetWithLoader(cacheKey, func(key string) (*models.WhiteRuleDO, error) {
// ..code
whiteRulesInner, err := h.whiteRuleService.List(ctx, whiteRuleQuery.Convert(ctx))
if err != nil {
return nil, err
}
return whiteRulesInner, nil
})JSON 反序列化
使用 Unmarshal 反序列化時(shí),結(jié)構(gòu)體的字段必須是首字母大寫,才能賦值成功,否則是默認(rèn)值。
Unmarshal NPE
err := json_utils.Unmarshal(record.Value, fr) 報(bào)錯(cuò) ReadVal: can not read into nil pointer, error found
這個(gè)錯(cuò)誤信息 "ReadVal: can not read into nil pointer, error found" 指的是在使用 json_utils.Unmarshal 進(jìn)行 JSON 反序列化時(shí),嘗試將 JSON 數(shù)據(jù)解碼到一個(gè)未初始化(nil)的指針變量 fr 中。
在 Go 語言中,如果有一個(gè)指針類型變量,如 *SomeStruct,在調(diào)用 Unmarshal 方法對(duì) JSON 數(shù)據(jù)進(jìn)行反序列化前,你需要確保該指針已經(jīng)指向了一個(gè)實(shí)際的結(jié)構(gòu)體實(shí)例,而不是 nil。
圖片
字段未導(dǎo)出
報(bào)錯(cuò) reflect.Value.Interface: cannot return value obtained from unexported field or method
字段名需要改成首字母大寫。
func (e *ElementOperationHistoryDO) SetDetail(detail any) {
if detail != nil {
detailType := reflect.TypeOf(detail).String()
struct_utils.SetFieldValue(detail, DetailType, detailType)
e.DetailInfo = struct_utils.StructToMap(detail)
}
}
func SetFieldValue(obj any, fieldName string, value any) {
v := reflect.ValueOf(obj).Elem()
if v.Kind() != reflect.Struct {
return
}
field := v.FieldByName(fieldName)
if !field.IsValid() {
return
}
field.Set(reflect.ValueOf(value))
}
將
detailInfo := &models.FileElementOperationDetailInfo{
Fpath: v.FileResponseAgentParam.FileName,
} 傳給 detail
圖片
實(shí)際參數(shù)多了
internal/ids_detect/eventflow/ability/UnifiedSsdeepDetect.go:157:62: got 3 type arguments but want 2
函數(shù)聲明了 2 個(gè)泛型參數(shù),卻傳入了 3 個(gè)泛型參數(shù)。
圖片
圖片
Reference
[1]Go 包循環(huán)引用及對(duì)策:https://www.cnblogs.com/lovesqcc/p/18077717































