Mozilla sccache本地磁盘缓存大小配置问题解析

问题背景

Mozilla sccache是一个分布式编译缓存工具，能够显著提升编译速度。在实际使用中，用户发现通过配置文件设置的本地磁盘缓存大小无法生效，最大缓存始终被限制在10GB。这个问题在Windows和Linux平台上都可能遇到。

问题表现

用户通过配置文件设置缓存大小为27GB：

[cache.disk]
size = 27516192768

但通过sccache -s命令查看时，最大缓存大小仍然显示为10GB。这个问题在sccache 0.8.0及更早版本中存在。

问题原因

经过分析，这个问题主要有两个根源：

1. 环境变量配置问题：早期版本中，通过SCCACHE_CACHE_SIZE环境变量设置缓存大小存在解析问题，无法正确识别设置的值。

2. 配置文件路径问题：在Windows系统上，sccache会尝试从多个位置读取配置文件，包括%APPDATA%\Mozilla\sccache\config\config和%LOCALAPPDATA%\Mozilla\sccache\config\config。如果配置文件放错位置，会导致配置无法被正确加载。

解决方案

这个问题在sccache 0.8.1版本中已得到修复。用户可以通过以下步骤解决：

1. 升级到最新版本：确保使用sccache 0.8.1或更高版本。

2. 正确放置配置文件：将配置文件放在正确的位置：

   • Windows: %LOCALAPPDATA%\Mozilla\sccache\config\config
   • Linux: ~/.config/sccache/config

3. 使用正确的配置格式：确保配置文件中使用正确的数字格式，不要使用27G这样的简写形式，而应该使用完整的字节数表示。

验证方法

用户可以通过以下方式验证配置是否生效：

1. 启用调试日志：

SCCACHE_LOG=debug SCCACHE_START_SERVER=1 SCCACHE_NO_DAEMON=1 sccache

2. 查看统计信息：

sccache --show-stats

在输出中检查"Max cache size"字段是否显示为配置的值。

技术细节

sccache的磁盘缓存实现使用LRU(最近最少使用)算法管理缓存内容。缓存大小限制是为了防止缓存占用过多磁盘空间。在早期版本中，这个限制值被硬编码为10GB，即10737418240字节，导致用户配置无法覆盖默认值。

新版本改进了配置加载逻辑，确保用户配置能够正确覆盖默认值。同时，配置解析也更加严格，能够正确识别各种数字格式。

最佳实践

1. 始终使用最新版本的sccache
2. 使用完整的字节数而非简写形式配置缓存大小
3. 定期检查缓存统计信息，确认配置生效
4. 对于大型项目，建议设置足够大的缓存空间(至少20GB以上)

通过正确配置sccache的缓存大小，可以显著提高编译效率，特别是对于大型项目的重复编译场景。