做完事情就總結,是個好習慣。
花了一個多月,將寫了一年半多的 Java 工程遷移到 Go 上。來小結下學到的東西吧!
一些基礎
map 訪問
Java
map.get(key) or map.getOrDefault(key, defaultValue)
Go
if value, ok := map[key] ; ok {
// ...code
}
強制類型轉換
注意,轉換爲 *Struct 和 轉換爲 Struct 並不等同。如果你的值是指針,那麼轉換爲結構體會報錯;反之亦然。
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。
有兩個小區別:
- 對 nil 進行 foreach , java 會報 NPE ,但是 Go 不會;
- 對 nil 調用方法,java 會報 NPE, 但 Go 不會。
給定代碼如下:
- range arr 時,Go 不會拋錯,java 會;
- Go 能夠調用 SayHello 方法,調用 GetName() 時,在 return s.Name 報錯了,而不是在 GetName 的調用行數報錯。說明它走到方法裏面了。問了下通義千問,大意是,方法並不屬於對象的內部數據結構,因此對 nil 訪問方法會轉到該結構體的方法表,但如果訪問 nil 的內部數據結構,則一定會拋 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
}
錯誤處理
Go 的錯誤處理與 Java 也很有區別。
- Go 通過返回值返回錯誤,必須對錯誤處理,如果忽略錯誤,則程序會繼續往下走,直到走完流程,或者在其它地方遇到 panic, 則會自動終止,如果沒有日誌,則程序什麼都不輸出(排查會很蛋疼)。
- Java 如果遇到運行時異常,會自動往上拋,遇到能夠捕獲的就處理,不能捕獲的繼續往上拋,如果沒有任何處理,則最終會拋出異常。
換句話說,Go 的錯誤如果忽略又不打日誌,程序就會毫無輸出,對排查很不方便。Go 錯誤處理的一些推薦做法:
- 前端錯誤,打印請求參數(爲空可以不打),直接返回 error;【強制】
- 底層方法,比如 repository ,必須返回 errror ,方便上層根據錯誤處理;【強制】
- 檢測流程,創建出錯,直接終止流程,並返回 Error;【強制】
- 非數據庫錯誤,返回 InternalError ;【推薦】
- 工具類方法,推薦返回 error ;【推薦】
- 上層方法,根據情形處理:如果不影響流程,則打印錯誤日誌,然後繼續往下走;如果影響流程,直接終止流程,拋出 error 。
- API (庫方法、數據庫、中間件、外部接口等)返回的錯誤必須捕獲處理,否則程序會無聲息終止。
Go 報錯
不得不說, Go 的報錯真的是很有迷惑性,有點不知所云。看半天都看不出什麼問題,真是費眼睛!因此,我總結了些常見報錯類型,方便以後更快排查。
重名類
可能是有兩個重名類 DO
Cannot use 'oldModels' (type []"xxx/internal/common/dal/service".T) as the type []"github.com/samber/lo".T
變量 models 與包名衝突
有時,你會發現包引用裏有這個實例或對象聲明,但 IDE 就是報錯,找不到。很可能方法裏的局部變量與包名衝突了。如下所示,有一個包名 models,又聲明瞭一個 models 變量,當然找不到啦!但是,這種問題很難察覺。就像 Javascript 裏,前面聲明瞭一個 password 變量,後面不小心寫成了 passord ,javascript 是不會報錯的(現在不知道會不會,好久沒寫 js 了)。
反序列化錯誤
reason 字段的上報數據與類型定義不一致。
存在包已經被刪除但引用沒有刪除
通常是因爲之前在某個類裏引用了某個包,後面又刪除了這個包,或者更改了包的位置導致。
循環包引用
在 ”Go 包循環引用及對策 “ 一文裏已經有講解過。
方法簽名不一致
類似問題可能是方法簽名不一致,比如方法函數簽名有返回值而實際傳入函數無返回值
cannot use calc (variable of type func()) as async.Consumer value in argument to taskExecutor.SubmitTask
函數參數沒有命名,只有類型
Function has both named and unnamed parameters '(ctx context.Context, []D)'
方法實現不對
Go 沒有支持 lambda 表達式。寫慣了 Java 導致。
報錯: 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 處 報錯: Cannot use 'whiteRulesInner' (type []T) as the type *models.WhiteRuleDO
實際上 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 NPE
err := json_utils.Unmarshal(record.Value, fr) 報錯 ReadVal: can not read into nil pointer, error found
這個錯誤信息 "ReadVal: can not read into nil pointer, error found" 指的是在使用 json_utils.Unmarshal
進行 JSON 反序列化時,你嘗試將 JSON 數據解碼到一個未初始化(nil)的指針變量 fr
中。
在 Go 語言中,如果你有一個指針類型變量,如 *SomeStruct
,在調用 Unmarshal 方法對 JSON 數據進行反序列化前,你需要確保該指針已經指向了一個實際的結構體實例,而不是 nil。
字段未導出
報錯 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
實際參數多了
internal/ids_detect/eventflow/ability/UnifiedSsdeepDetect.go:157:62: got 3 type arguments but want 2
依賴注入出錯
報錯:panic: DI: could not find service XXX , available services : xxx
有一個類依賴的 XXX 沒有加星號。這個可能與庫 dow 的使用有關。