Roo-Code项目中Google Gemini 2.5 Pro API集成问题的分析与解决

在Roo-Code项目3.14版本中，开发团队发现了一个与Google Gemini API集成相关的重要技术问题。当用户尝试使用Google Gemini API提供商的gemini-2.5-pro-preview-03-25模型时，系统会返回400错误提示API密钥已过期，或者直接陷入无响应状态。值得注意的是，相同的API密钥在其他模型上工作正常，这表明问题并非真正的密钥过期。

经过深入分析，技术团队发现该问题具有以下特征：

1. 仅影响Google Gemini API提供商下的特定模型gemini-2.5-pro-preview-03-25
2. 相同模型通过Vertex AI API提供商可以正常工作
3. gemini-2.5-pro-exp模型在相同环境下表现正常
4. 问题似乎与3.14版本引入的缓存更新机制有关

多位用户报告了类似现象，包括请求超时、服务不可用错误以及上下文token计数异常增加等情况。技术团队通过版本回滚测试确认，在3.13.2版本中该功能完全正常，这进一步缩小了问题范围。

问题根源最终被定位到缓存机制的实现上。在3.14版本中引入的缓存功能与Google Gemini API的特定模型存在兼容性问题。技术团队迅速响应，在短时间内发布了修复方案，成功解决了这一集成问题。

这一案例展示了API集成过程中可能遇到的复杂问题，特别是在引入新功能如缓存机制时，需要对不同API提供商和模型版本进行充分测试。对于开发者而言，当遇到类似API集成问题时，版本回退测试和不同环境对比是有效的诊断手段。