Proto 限制

本主题记录了 proto 模式中支持的元素（字段、枚举值等）数量的限制。

这些信息是许多工程师发现的限制集合，但并非详尽无遗，某些方面可能不正确或已过时。当您在工作中发现限制时，请将其贡献给本文档以帮助他人。

字段数量

仅包含单一 proto 字段（如布尔型）的消息

• ~2100 个字段 (proto2)
• ~3100 个 (proto3 不使用 optional 字段)

通过单一字段（如布尔型）扩展的空消息

• ~4100 个字段 (proto2)

proto3 不支持扩展。

要测试此限制，请创建一个字段数量超过上限的 proto 消息，并使用 Java proto 规则进行编译。此限制源自 JVM 规范。

枚举值的数量

最低限制是 Java 中的约 1700 个值。其他语言有不同的限制。

消息的总大小

任何序列化形式的 proto 都必须小于 2GiB，因为这是所有实现支持的最大大小。建议限制请求和响应的大小。

Proto 反序列化的深度限制

• Java: 100
• C++: 100
• Go: 10000 (有计划将其减少到 100)

如果您尝试反序列化嵌套深度超过限制的消息，反序列化将失败。