前言

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

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

场景

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

1
2
3
4
5
6
7

type Status uint32

const (
	StatusOpen Status = iota
	StatusClosed
	StatusUnknown
)

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

1
2
3

StatusOpen = 0
StatusClosed = 1
StatusUnknown = 2

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

1
2
3
4
5

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

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

1
2
3
4
5

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

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

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

1
2
3
4

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

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

最佳实践

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

1
2
3
4
5
6
7

type Status uint32

const (
	StatusUnknown Status = iota
	StatusOpen
	StatusClosed
)

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

开源地址

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

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

个人网站：Jincheng’s Blog。

知乎：无忌。

References