Go 开发踩过的那些坑（适合Java转Go）
做完事情就总结，是个好习惯。
花了一个多月，将写了一年半多的 Java 工程迁移到 Go 上。来小结下学到的东西吧！
一些基础
Java 枚举转成 Go
Java
public enum DetectionMethodEnum {
PROCESS_HASH("process_hash", "进程Hash检测"),
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: "进程Hash检测"
}
}
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 通过返回和判断单独的 error 来进行错误，应用必须对错误处理。如果忽略错误，则程序会继续往下走，直到走完流程，或者在其它地方遇到 panic 而终止。如果没有捕获错误，且没有日志，则程序什么都不输出（排查会很蛋疼）。就好像突然在哪里断掉了，但是你没法知道在哪里断掉了。
-
Java 如果遇到运行时异常，会自动往上抛，遇到捕获的就按照指定程序处理，没有捕获的继续往上抛。如果没有任何处理，则最终会抛出异常。如果捕获了异常却不处理，也会什么都不输出，当然，这是自找罪受。
换句话说，Go 的错误如果忽略又不打日志，程序就会毫无输出，对排查很不方便。这意味着：Go 做处理处理会比较繁琐，每一个方法如果有错误就应该抛出，每一个错误都必须决定是否处理，还是继续往上抛。益处是：能够培养缜密的错误处理习惯。像 Java 那样随意，肯定会遭到惩罚。
Go 错误处理的一些推荐做法：
- 前端错误，打印请求参数（为空可以不打），在 error 里返回错误码和错误信息【强制】。
- 存储层方法，比如 repository ，必须返回 errror ，方便上层根据错误处理【强制】。
- 检测流程，创建出错，直接终止流程，并返回 Error【强制】。
- API （库方法、数据库、中间件、外部接口等）返回的错误必须捕获处理，否则程序会无声息终止【强制】。
- 非数据库错误，如果有错误码的，返回错误码和错误信息；没有错误码的，默认返回 InternalError 或 SystemError【推荐】。
- 编写工具类方法，推荐返回 error 【推荐】。
- 上层方法，根据情形处理：如果不影响流程（局部失败不影响整体失败的情形），则打印错误日志，然后继续往下走；如果影响流程，直接终止流程，抛出 error 。
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 的使用有关。
