Как проектировать gRPC API так, чтобы оно было backward compatible при эволюции схемы?

Question

Нельзя переиспользовать номера полей, нельзя менять типы, нельзя убирать поля. Новые поля — только с новыми тегами. Используются reserved поля, wrapper-типы и расширяемые структуры.

YeaHub · Accepted Answer

1. Никогда не изменять номера полейДаже если поле удалено → отмечаем:reserved 3;
reserved "old_field"2. Нельзя менять тип поляЭто ломает бинарную совместимость.3. Добавление новых полей — безопасноСтарый клиент их игнорирует.4. Использовать wrapper-типы (google.protobuf.*Value)Чтобы различать “не передано” и “нулевое значение”.5. Oneof вместо enumУдобно эволюционирует.6. Версионирование пакетовmy.service.v1, my.service.v2.7. Deprecation policyНельзя «ломать» контракты без подготовки.