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

快速结论：该报错出现在 RAGFlow 的 Go 模型驱动中，GoogleProvider 的连接检查永远返回 “no such method”，即使 Gemini API Key 有效。优先排查是否使用了较旧的 RAGFlow 代码版本，并检查是否已合并修复 PR。

适用环境：RAGFlow main 分支源码构建版本（commit 5e96c5c），Google / Gemini API，Go 模型驱动，google.golang.org/genai SDK。操作系统无关。

最快修复方案：暂无确认的一步修复方案。官方已确认这是代码 stub 缺陷，需要应用修复补丁（PR #14660 或 #14661），将 CheckConnection 委托给 ListModels 并补充 API Key 校验。

注意事项：该修复补丁在 Issue 关闭时尚未合并到 main 分支；使用修复分支时需重新编译 Go 驱动并运行回归测试。

问题场景

在 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 方法签名匹配。

解决步骤

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