Go 開發踩過的那些坑（適合Java轉Go）

琴水玉發表於2024-03-30
GoJava

做完事情就總結，是個好習慣。


花了一個多月，將寫了一年半多的 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 []"git.qingteng.cn/ms-app-ids/service-ids/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 的使用有關。

相關文章