2024 年 11 月 7 日宣布的变更

以下各节介绍了计划在 v30 版本（预计于 2025 年第一季度发布）中进行的重大变更。此外还包括一些非重大但可能需要您采取行动的变更。这些是 10 月 2 日新闻文章中提到的变更之外的补充。

这些描述是我们预期的变更实现方式，但由于软件的灵活性，其中一些变更可能不会最终实施，或者可能与本主题中的描述有所不同。

在 Arena 上清除 Oneof 消息后引入 ASAN Poisoning

此变更增加了一项强化检查，影响使用 Arena 的 C++ protobufs。在 protobuf Arena 上分配的 Oneof 消息现在将在调试模式下被清除，并在 ASAN 模式下被“投毒”（poisoned）。调用 clear 后，未来尝试使用该内存区域将在 ASAN 中导致崩溃，报告为 use-after-free 错误。

此实现需要 C++17。

Python map 字段的 setdefault 行为变更

从 v30 开始，setdefault 对于 ScalarMap 将类似于 dict，但键和值都必须设置。对于 MessageMaps，setdefault 将被拒绝。

移除已弃用的 py_proto_library 宏

在 protobuf.bzl 中已弃用的内部 py_proto_library Bazel 宏将在 v30.x 中被移除。

应将其替换为官方的 py_proto_library，该库将从 v29.x 开始移至 protobuf 的 bazel/py_proto_library 中。在 v29.x 之前，此实现可在 rules_python 中找到。

Python 嵌套消息类的 __qualname__ 包含外部消息名称

Python 嵌套消息类的 __qualname__ 现在包含外部消息的名称。在 v30 之前，对于嵌套消息，__qualname__ 与 __name__ 的结果相同，即不包含外部消息的名称。

例如：

message Foo {
  message Bar {
    bool bool_field = 1;
  }
}
nested = test_pb2.Foo.Bar()
self.assertEqual('Bar', nested.__class__.__name__)
self.assertEqual('Foo.Bar', nested.__class__.__qualname__) # It was 'Bar' before

停止发布 C++ CocoaPods

在 v30 中，我们将停止发布 C++ CocoaPods 版本，该版本自 v4.x.x 以来一直处于损坏状态。C++ 用户应直接使用我们的 GitHub release。

Ruby 和 PHP 在 JSON 解析中的错误

v30 根据 JSON 规范修复了在解析数字字段中的字符串时不合规的问题。

此修复不会伴随主版本号的提升，但 Ruby 和 PHP 现在将对数字字段中的非数字字符串（例如“”、“12abc”、“abc”）引发错误。v29.x 将针对这些错误情况包含警告。