Go jsontext token 读取到数组末尾时为什么还有 EndArray

我第一次用 encoding/json/jsontext 做 token 级读取时，最容易误判的日志就是：数组里的最后一个值已经拿到了，下一次读取却又出现 EndArray。这不是重复元素，也不是解码器多读了一次；EndArray 就是 JSON 的 ]，它负责告诉状态机“当前数组已经闭合”。

读取 token 时要把数组的开始标记、元素和结束标记分开看。遇到 KindEndArray，先结束当前数组分支；只有整个顶层值读完后，才用 io.EOF 判断输入流结束。

EndArray 为什么一定会被读到

jsontext.Token 面向的是 JSON 语法，不是已经装配好的业务对象。对于 [10,20]，读取序列可以理解为 BeginArray、数字 10、数字 20、EndArray。逗号不会单独生成 token，因为它可以从数组状态推断出来；但右方括号决定了嵌套层何时关闭，必须保留。

官方文档把对象和数组的嵌套状态保存在解码器内部：读到 BeginArray 或 BeginObject 时深度增加，读到对应的结束 token 时深度减少。因此，最后一个业务元素和数组结束之间多一次 ReadToken 是正常的结构读取过程。

用 Kind 和 StackDepth 正确结束数组循环

不要拿 token 与 jsontext.EndArray 直接比较：Token 可能由解码器内部缓冲区支持，实际判断应使用 tok.Kind()。下面的例子只消费一个顶层数组，遇到 KindEndArray 就退出当前数组，遇到 io.EOF 才表示整个输入流没有更多顶层值。

package main

import (
    "fmt"
    "io"
    "strings"

    "encoding/json/jsontext"
)

func main() {
    dec := jsontext.NewDecoder(strings.NewReader(`[10, {"ok": true}, 30]`))
    depth := 0

    for {
        tok, err := dec.ReadToken()
        if err == io.EOF {
            // 只有顶层值结束后到这里，才把 EOF 当作输入流结束。
            break
        }
        if err != nil {
            // 语法错误不能当成数组结束，否则会掩盖坏输入。
            panic(err)
        }

        switch tok.Kind() {
        case jsontext.KindBeginArray:
            depth++
            fmt.Println("进入数组，深度:", depth)
        case jsontext.KindEndArray:
            fmt.Println("结束数组，深度:", dec.StackDepth())
            depth--
            if depth == 0 {
                // 当前示例只有一个顶层数组，EndArray 后退出数组循环。
                return
            }
        default:
            // 业务代码在这里处理字符串、数字或对象边界 token。
            fmt.Println("token:", tok.String())
        }
    }
}

这里的 depth 是示例业务计数，dec.StackDepth() 是解码器维护的语法深度。读到顶层 EndArray 后，解码器深度已经回到 0；如果数组里嵌套数组，内层 EndArray 只会让深度下降一层，不能提前结束顶层处理。

为什么在 EndArray 位置调用 ReadValue 会报错

ReadToken 读取一个结构或字面量 token，ReadValue 读取一个完整 JSON 值。数组的 ] 是容器的结束标记，不是一个可以独立交给 ReadValue 的值。官方说明中，解码器已经位于对象或数组结束 token 时调用 ReadValue 会返回 SyntacticError，内部状态保持不变。

实战中可以先用 PeekKind 看下一项，再决定走 token 还是 value，但要记住它不会推进偏移，而且错误会被缓存，后续仍需跟一次读取。若逻辑只关心数组元素，读到 KindEndArray 就消费并退出；若元素是大对象，可使用 ReadValue 一次取出整个对象，别再把它拆成同一层的 token。

排查日志时还要注意 Token 的有效期

从 Decoder.ReadToken 返回的原始 token 可能由解码器内部缓冲区支撑，只保证在下一次 Peek、Read 或 Skip 调用前有效。要把 token 保存到循环外或异步处理，先调用 tok.Clone()；仅把 tok.String() 打到日志通常不需要保存原 token。

相关问题

EndArray 和 io.EOF 是一回事吗？

不是。EndArray 只表示一个数组结束，后面可能还有对象字段或下一个顶层 JSON 值；io.EOF 表示底层输入暂时或最终没有更多 token。

怎样判断已经回到顶层？

读取结束 token 后观察 dec.StackDepth() 是否为 0，并结合自己的顶层值处理状态。不要只用“这是数组里的最后一个元素”做判断。

为什么不直接把整个数组读成 Value？

如果不需要逐项处理，ReadValue 更简单；只有需要流式处理、保留语法边界或控制内存时，才适合逐 token 读取。

把 EndArray 当作结构信号而不是异常，循环就会清晰很多：元素负责业务，结束 token 负责收口，io.EOF 负责输入流生命周期。