proto3现有基本类型字段添加optional的兼容性及Go代码适配问题

1. 给现有基本类型字段添加optional的向后兼容性 #

从Wire协议层面是兼容的：

• 旧版本proto发送的消息：如果字段值为默认值（比如int32的0），不会被序列化到Wire数据中；新版本proto接收时会将该optional字段判定为「未设置」。如果旧版本发送非默认值，新版本能正常识别为已设置。
• 新版本proto发送的消息：如果optional字段未设置，Wire数据中不会包含该字段；旧版本接收时会将该字段解析为默认值0。如果已设置值，旧版本能正常解析对应数值。

但语义层面存在差异：旧版本无法区分「未设置」和「设置为默认值0」，新版本可以。如果你的业务逻辑依赖这种区分，需要确保新旧服务/客户端都适配语义变化，否则可能出现逻辑错误。

2. Go代码生成后是否破坏现有代码 #

会直接破坏现有代码。原因是：

• 原proto生成的Go字段是值类型：ExistingField int32
• 添加optional后生成的Go字段是指针类型：ExistingField *int32

现有代码中直接访问该字段的逻辑（比如if example.ExistingField == 0、fmt.Println(example.ExistingField)）会出现编译错误，必须修改为指针操作：

• 判断是否未设置：if example.ExistingField == nil
• 获取字段值：*example.ExistingField

如果你的项目无法同步修改所有依赖该字段的Go代码，这种方式会导致兼容性问题。

3. 废弃旧字段并创建新字段是否为正确做法 #

这是保持完全向后兼容的稳妥方案，尤其当你无法修改现有Go代码或需要严格兼容旧语义时。具体做法如下：

更新后的proto定义：

syntax = "proto3";

message Example {
    int32 existing_field = 1 [deprecated = true]; // 标记旧字段为废弃
    optional int32 existing_field_v2 = 2; // 新增可选字段用于区分未设置和默认值
}

保持向后兼容性的处理指导 #

根据你的业务场景选择适配方案：

方案一：使用optional字段（允许修改现有代码）

• 确认所有依赖该proto的Go代码可以同步修改，适配指针类型的字段操作。
• 业务逻辑中明确区分「未设置」（指针为nil）和「设置为默认值0」（指针非nil且值为0）。
• 注意旧客户端发送的默认值0会被新服务判定为「未设置」，如果业务需要将这种情况视为「设置为0」，需要额外处理。

方案二：废弃旧字段+新增可选字段（完全兼容旧代码）

• 旧字段保留并标记为deprecated，禁止新代码使用，但仍兼容旧客户端/服务的请求。
• 新业务逻辑使用新增的optional字段，实现「未设置」和「默认值」的区分。
• 逐步迁移旧代码到新字段，待所有依赖都完成迁移后，再考虑移除旧字段（注意：移除旧字段可能影响仍在使用它的旧客户端，需谨慎）。

内容的提问来源于stack exchange，提问作者Nishant Bansal