[Bug]: Google Go model connection check always returns no such method

问题场景

在 RAGFlow 中配置 Google AI Studio / Gemini API 作为模型提供商，并触发连接检查时触发此问题。用户使用有效的 API Key，但GoogleModel.CheckConnection始终返回固定错误，导致连接检查误报失败。即使 GoogleModel.ListModels 能正常调用 Google GenAI SDK 并列出模型，连接检查依然失败。

报错原文

[Bug]: Google Go model connection check always returns no such method

Error: no such method

原因分析

这是已确认的代码缺陷。在 internal/entity/models/google.go 中，GoogleModel.CheckConnection 方法只是一个存根（stub），无条件返回 fmt.Errorf("no such method")，即使 GoogleModel.ListModels 已完整实现并能正常配合 Google GenAI SDK 工作。由于连接检查被硬编码为固定错误，真实 API 错误（如 API 被禁用、Key 无效、权限不足）也被掩盖，无法在连接检查中正确反馈。

此外，GoogleModel.ListModels 在解引用 apiConfig.ApiKey 前未校验 apiConfig 和 ApiKey 是否存在，当凭据缺失时可能触发 nil 指针解引用（panic），而非返回正常的参数校验错误。

环境排查

• 确认 RAGFlow 代码 commit 是否为 5e96c5cae6add24c10f6b9c48d69006a901e9419 或更早版本（该版本包含此缺陷）。
• 检查 Go 环境及 internal/entity/models 包是否可正常编译。
• 确认 Google AI Studio / Gemini API Key 是否有效（可先用 API 工具或 curl 直接验证）。
• 查看 google.golang.org/genai SDK 版本，确保驱动代码与 SDK 方法签名匹配。

解决步骤

1. 访问 GitHub 上的修复 PR #14660 或 #14661，查看具体补丁内容。
2. 将补丁应用到 internal/entity/models/google.go：
   • 将 GoogleModel.CheckConnection 委托给 GoogleModel.ListModels，删除硬编码的 “no such method” 返回。
   • 在 ListModels 和 CheckConnection 入口处增加 apiConfig 及 ApiKey 的 nil/空值校验，缺失时返回正常校验错误而非 panic。
   • 保持将 Google SDK 返回的错误直接向上传递，让连接检查结果反映真实 API 状态。
3. （可优先尝试）如果无法直接合并 PR，可手动修改代码后重新编译 Go 驱动。
4. 运行回归测试确认改动无误：go test -count=1 ./internal/entity/models（如需竞态检查可加 -race）。

验证方法

修复后可使用有效 Gemini API Key 调用 model.CheckConnection(apiConfig)，应当返回成功而非 “no such method”；使用无效 Key 时应当返回 Google API 的原始错误信息。同时验证 ListModels 能正常返回模型列表（修复验证中返回了 50 个模型），且在不传 API Key 时返回参数错误而非 panic。运行 go test -count=1 ./internal/entity/models 确认全部测试通过。

参考来源

infiniflow/ragflow #14703

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。