Google Closure Compiler 与 Protobuf 3.25.6 兼容性问题解析

问题背景

Google Closure Compiler 是一个强大的 JavaScript 优化工具，能够对代码进行压缩、优化和类型检查。近期，当用户在使用 Closure Compiler 配合 Protocol Buffers (protobuf) 3.25.6 版本时，遇到了一个兼容性相关的异常问题。

异常现象

在运行过程中，系统会抛出以下错误：

java.lang.UnsupportedOperationException: As of 2022/09/29 (release 21.7) makeExtensionsImmutable should not be called from protobuf gencode...

该异常明确指出，从 protobuf 21.7 版本开始，makeExtensionsImmutable 方法不应再从生成的代码中调用。如果用户看到此消息，说明生成的代码存在潜在问题。

技术原因

这个问题的根源在于 Protocol Buffers 团队发现了一个潜在的兼容性问题。为了改进代码结构，protobuf 在 21.7 版本中引入了一个破坏性变更，移除了对 makeExtensionsImmutable 方法的支持。

当 Closure Compiler 使用 protobuf 3.25.6 版本时，由于编译器内部生成的代码仍然尝试调用这个方法，触发了这个保护机制，导致异常抛出。

解决方案

对于遇到此问题的用户，有以下几种解决途径：

1. 升级 Closure Compiler：最新版本的 Closure Compiler 已经修复了这个问题，用户可以通过升级到最新版本来解决兼容性问题。

2. 临时解决方案：如果暂时无法升级，可以通过设置 JVM 系统属性来调整行为：

   -Dcom.google.protobuf.use_unsafe_pre22_gencode
   

   但需要注意，这会使得系统使用旧版代码生成方式。

3. 降级 protobuf：如果项目环境允许，可以考虑降级到 protobuf 21.7 之前的版本，但这可能会影响其他功能。

最佳实践

对于生产环境，建议采取以下措施：

1. 优先考虑升级到最新版本的 Closure Compiler，这是最可靠的解决方案。

2. 如果必须使用旧版本，确保了解潜在的兼容性问题，并采取适当的措施。

3. 定期检查项目的依赖关系，确保所有组件都保持最新状态。

技术影响

这个问题主要影响以下场景：

• 使用 Closure Compiler 进行 JavaScript 代码压缩和优化的构建流程
• 项目中同时依赖 protobuf 3.25.6 或更高版本
• 使用基于 protobuf 的序列化/反序列化功能

对于大多数前端构建场景，这个问题的实际影响相对较低，因为主要涉及的是构建时的代码生成过程，而非运行时环境。然而，遵循最佳实践仍然十分重要。

总结

Protocol Buffers 作为广泛使用的序列化框架，其更新需要开发者重视。Closure Compiler 团队已经跟进修复了这个问题，建议用户及时更新以避免兼容性问题。在软件开发中，保持依赖库的及时更新是维护项目稳定性的重要环节。