Go 开发踩过的那些坑（适合Java转Go）

news/发布时间2024/5/3 18:47:07

养成总结的习惯。

花了一个多月，将写了一年半多的 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 = nilfor i := range arr {fmt.Println(i)}var stu *Stustu.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 是不会报错的。

依赖注入出错

报错：panic: DI: could not find service XXX , available services : xxx

有一个类依赖的 XXX 没有加星号。这个可能与库 dow 的使用有关。

反序列化错误

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) {// ..codewhiteRulesInner, 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