simdjson解析器处理文档根数组时对多余闭合括号的处理机制

simdjson作为一款高性能JSON解析器，在处理文档根数组时有一个值得注意的特性：它不会立即拒绝包含多余闭合括号的JSON数组。这一行为看似违反直觉，但实际上是有意为之的设计选择。

问题现象

当使用simdjson的ondemand解析器处理类似["extra close"]]这样的JSON字符串时，解析器不会立即报错。这种字符串在语法上是不规范的，因为它包含了一个多余的闭合方括号。

设计原理

simdjson采用了一种"按需解析"的设计理念。解析器在初始阶段不会验证整个文档的完整性，而是等到实际访问数据时才进行验证。这种延迟验证的策略带来了显著的性能优势，特别是处理大型JSON文档时。

正确使用方法

要检测文档中是否存在多余内容（如多余的闭合括号），开发者需要显式检查文档是否已完全消费：

1. 首先解析并获取数组
2. 遍历数组中的所有元素
3. 最后检查文档是否还有未消费的内容

示例代码

auto json = R"(["extra close"]])"_padded;
ondemand::parser parser;
ondemand::document doc = parser.iterate(json);
ondemand::array array = doc.get_array();

// 消费数组内容
for (std::string_view values : array) {
    std::cout << values << std::endl;
}

// 检查是否有剩余内容
if(!doc.at_end()) {
    std::cerr << "发现多余内容，位置在字节索引: " 
              << doc.current_location() - json.data() << std::endl;
}

性能考量

这种设计允许解析器在不需要完整验证的情况下快速访问JSON数据。对于只需要部分数据的应用场景，可以避免不必要的完整文档验证开销。

最佳实践

1. 如果应用需要确保JSON文档格式完全正确，应在使用数据后检查文档是否完全消费
2. 对于关键应用，考虑在解析后立即验证文档完整性
3. 了解这种特性可以避免在性能敏感场景中进行不必要的完整验证

simdjson的这种设计体现了在性能与严格验证之间的权衡，开发者需要根据具体应用场景选择适当的验证策略。