CARLA 模拟器中 CMake 下载错误代码 35 的解决方案剖析

背景介绍

在构建 CARLA 模拟器项目时，开发团队遇到了一个棘手的构建问题。当使用 CMake 的 FetchContent 和 ExternalProject 模块从 GitHub 下载依赖项（特别是 StreetMap 仓库）时，系统会频繁出现 SSL 连接错误，错误代码为 35，状态描述为 "SSL connect error"。这个错误会导致构建过程中断，严重影响开发效率。

问题本质

CMake 的下载机制内置了一套错误重试策略，但错误代码 35 并未被包含在可重试错误代码列表中。这意味着当 SSL 连接出现短暂性问题时，CMake 不会自动重试下载操作，而是直接报错退出。这种设计在稳定的网络环境下可能没有问题，但在实际开发中，特别是跨国网络环境下，SSL 握手失败是一个相对常见的临时性问题。

技术细节

SSL 错误代码 35 (SSL connect error) 通常表示在 SSL/TLS 握手过程中出现了问题。这可能是由于：

1. 网络连接不稳定导致握手中断
2. 服务器端临时过载
3. 客户端和服务器之间的中间网络设备干扰
4. 临时的证书验证问题

在大多数情况下，这些问题都是暂时性的，简单的重试操作就能解决。然而，CMake 的原始代码并未将这类错误识别为可重试错误。

解决方案

针对这个问题，开发团队提出了一个优雅的解决方案：修改 CMake 的下载模块，将错误代码 35 添加到可重试错误列表中。具体修改的文件是 CMake 源码中的 Modules/ExternalProject/download.cmake.in。

这个修改虽然简单，但意义重大：

1. 提高了构建过程的健壮性
2. 减少了因临时网络问题导致的构建失败
3. 保持了与现有 CMake 功能的兼容性
4. 不需要用户端做任何额外配置

实施建议

对于使用 CARLA 模拟器的开发者，在等待这个修复被合并到 CMake 主分支之前，可以采取以下临时解决方案：

1. 使用项目提供的 CMake 分支
2. 在本地环境中手动应用相同的补丁
3. 设置更宽松的网络代理策略（如果适用）
4. 在持续集成环境中配置重试机制

未来展望

这个问题的解决不仅对 CARLA 项目有益，也将惠及所有使用 CMake 进行依赖管理的开源项目。它体现了开源社区协作解决共性问题的优势，也展示了构建系统在面对现实世界网络环境时需要具备的弹性设计理念。

随着云开发和分布式团队协作的普及，构建工具对网络问题的容错能力将变得越来越重要。这个补丁是向这个方向迈出的重要一步。