Proto 限制

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

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

字段数量

仅包含奇异 proto 字段（例如 Boolean）的消息

• ~2100 个字段 (proto2)
• ~3100 (proto3，不使用可选字段)

由奇异字段（例如 Boolean）扩展的空消息

• ~4100 个字段 (proto2)

proto3 中不支持扩展。

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

枚举中值的数量

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

消息总大小

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

Proto 反序列化的深度限制

• Java: 100
• C++: 100
• Go: 10000（计划将其减少到 100）

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