Go の json.Marshal の思いがけない仕様

結論

json.Marshal は、uint8 型のスライスを base64 文字列にする。
int8 型だったり スライスじゃなくて配列だったりすると配列になるけど。

ソースコードと実行結果

golang

package main

import (
    "encoding/json"
    "fmt"
)

type S struct {
    U8Array  [3]uint8
    U8Slice  []uint8
    S8Array  [3]int8
    S8Slice  []int8
    U8SliceP *[]uint8
    PU8Slice []*uint8
    IFSlice []interface{}
}

func main() {
    a:=uint8(1)
    b:=uint8(2)
    c:=uint8(3)
    o := S{
        U8Array:  [3]uint8{1, 2, 3},
        U8Slice:  []uint8{1, 2, 3},
        S8Array:  [3]int8{1, 2, 3},
        S8Slice:  []int8{1, 2, 3},
        U8SliceP: &[]uint8{1, 2, 3},
        PU8Slice: []*uint8{&a, &b, &c},
        IFSlice: []interface{}{uint8(1),uint8(2),uint8(3)},
    }
    bytes, _ := json.Marshal(o)
    fmt.Println(string(bytes))
}

実行するとこうなる：

json

{
  "U8Array":[1,2,3],
  "U8Slice":"AQID",
  "S8Array":[1,2,3],
  "S8Slice":[1,2,3],
  "U8SliceP":"AQID",
  "PU8Slice":[1,2,3],
  "IFSlice":[1,2,3]
}

"AQID" について

base64 でデコードすると、下記の通り [1, 2, 3] になる。

ruby

require "base64"
Base64.decode64("AQID").bytes
# => [1, 2, 3]

まとめ

json.Marshal でシリアライズすると下表のようになる。

go上の型	json
uint8 の配列	数値の配列
uint8 のスライス	base64文字列
int8 の配列	数値の配列
int8 のスライス	数値の配列
uint8 のスライスへのポインタ	base64文字列
uint8 へのポインタのスライス	数値の配列
interface のスライスに uint8 だけを詰めたもの	数値の配列

思いがけない仕様で大変驚いた。
驚きは2点

• uint8 のスライスが base64文字列になる点。
• uint8 の スライス が base64文字列になるのに、uint8 の 配列 は数値の配列になる点。