Go十大常见错误第一篇：未知枚举值

前言

这是Go十大常见错误系列的第一篇：未知枚举值。素材来源于Go布道者，现Docker公司资深工程师Teiva Harsanyi^[1]。欢迎大家转载。

本文涉及的源代码全部开源在：Go十大常见错误源代码^[2]，欢迎大家关注公众号，及时获取本系列最新更新。

场景

让我们来看下面的代码示例：

type Status uint32

const (
 StatusOpen Status = iota
 StatusClosed
 StatusUnknown
)

这里我们使用iota定义了一个枚举，对应的枚举值分别是：

StatusOpen = 0
StatusClosed = 1
StatusUnknown = 2

假设我们业务代码里的数据结构包含了枚举类型，比如下例：

type Request struct {
 ID        int    `json:"Id"`
 Timestamp int    `json:"Timestamp"`
 Status    Status `json:"Status"`
}

我们要把接受到的JSON请求反序列化为Request结构体类型。

{
  "Id": 1234,
  "Timestamp": 1563362390,
  "Status": 0
}

对于上面这个JSON请求数据，Request结构体里的Status字段会被解析为0，对应的是StatusOpen，符合预期。

但是如果由于各种原因没有传Status字段，对于如下的JSON请求

{
  "Id": 1235,
  "Timestamp": 1563362390
}

在将这个JSON请求反序列化为Request结构体类型的时候，因为JSON串里没有Status字段，因此Request结构体里的Status字段的值会是零值，也就是uint32的零值0。这个时候Status字段的值还是StatusOpen，而不是我们预期的StatusUnknown。

最佳实践

因此对于枚举值的最佳实践，是把枚举的未知值设置为0。

type Status uint32

const (
 StatusUnknown Status = iota
 StatusOpen
 StatusClosed
)

这样设计后，如果JSON请求里没有传Status字段，那反序列化后的Request结构体里的Status字段的值就是StatusUnknown，符合预期。

开源地址

文章和示例代码开源在GitHub: Go语言初级、中级和高级教程^[3]。

公众号：coding进阶。关注公众号可以获取最新Go面试题和技术栈。

个人网站：Jincheng's Blog^[4]。

知乎：无忌^[5]。

References

• https://itnext.io/the-top-10-most-common-mistakes-ive-seen-in-go-projects-4b79d4f6cd65
• https://gobyexample.com/json

参考资料