Go 开发踩过的那些坑，你踩过几个？_Golang

一些基础

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 开发踩过的那些坑，你踩过几个？图片

错误处理

Go 的错误处理与 Java 也有较大区别。

Go 通过返回和判断单独的 error 来进行错误，应用必须对错误处理。如果忽略错误，则程序会继续往下走，直到走完流程，或者在其它地方遇到 panic 而终止。如果忽略错误（可使用 _ 表示），且没有日志（类似 Java catch 了但是什么都不做），则程序什么都不输出。就好像突然在哪里断掉了，但是你没法知道在哪里断掉了。问题排查会很蛋疼且耗时。
Java 如果遇到运行时异常，会自动往上抛，遇到捕获的就按照指定程序处理，没有捕获的继续往上抛。如果没有任何处理，则最终会抛出异常。如果捕获了异常却不处理，也会什么都不输出，当然，这是自找罪受。

换句话说，Go 的错误如果忽略又不打日志，程序就会毫无输出，对排查很不方便。这意味着：Go 做处理处理会比较繁琐，每一个方法如果有错误就应该抛出，每一个错误都必须决定是否处理，还是继续往上抛。益处是：能够培养缜密的错误处理习惯。像 Java 那样随意，肯定会遭到惩罚。

Go 错误处理的一些推荐做法：

前端错误，打印请求参数（为空可以不打），在 error 里返回错误码和错误信息【强制】。
存储层方法，比如 repository ，必须返回 errror ，方便上层根据错误处理【强制】。
检测流程，创建出错，直接终止流程，并返回 Error【强制】。
API （库方法、数据库、中间件、外部接口等）返回的错误必须捕获处理，否则程序会无声息终止【强制】。
非数据库错误，如果有错误码的，返回错误码和错误信息；没有错误码的，默认返回 InternalError 或 SystemError【推荐】。
编写工具类方法，推荐返回 error 【推荐】。
上层方法，根据情形处理：如果不影响流程（局部失败不影响整体失败的情形），则打印错误日志，然后继续往下走；如果影响流程，直接终止流程，抛出 error 。

Go 报错

不得不说， Go 的报错真的是有点不知所云。咋一看，看半天都看不出什么问题，真是费眼睛！因此，我总结了些常见报错类型，方便以后更快排查。

重名类

可能是有两个重名类 DO。比如有两个同名类 A 和 B，本来应当引用 A，结果引用了 B。

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 了）。

Go 开发踩过的那些坑，你踩过几个？图片

反序列化错误

reason 字段的上报数据与类型定义不一致。

Go 开发踩过的那些坑，你踩过几个？图片

存在包已经被删除但引用没有删除

通常是因为之前在某个类里引用了某个包，后面又删除了这个包，或者更改了包的位置导致。

Go 开发踩过的那些坑，你踩过几个？图片

循环包引用

在 ”Go 包循环引用及对策[1] “ 一文里已经有讲解过。

方法签名不一致

类似问题可能是方法签名不一致，比如方法函数签名有返回值而实际传入函数无返回值

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 开发踩过的那些坑，你踩过几个？图片

方法实现不对

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)

Go 开发踩过的那些坑，你踩过几个？图片

返回类型不一致

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 反序列化时，结构体的字段必须是首字母大写，才能赋值成功，否则是默认值。

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。

Go 开发踩过的那些坑，你踩过几个？图片

字段未导出

报错 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

Go 开发踩过的那些坑，你踩过几个？图片