常见症状
- 网页提示 Gemini 在当前国家/地区不可用
- API 返回
User location is not supported for the API use - 请求失败或回复中断
- Google 相关页面能打开,但每次都要卡几秒
先试这几步
- 在客户端连接面板确认 gemini.google.com 没有走直连
- 对照官方可用地区列表,换到支持地区的节点
- 程序调用时确认已设置
HTTPS_PROXY - 页面卡顿时尝试在规则中拒绝 UDP 443
核心结论
- 地区提示类错误需要换「地区」,而不是换更快的节点。
- 出口地区正确仍不可用,可能与账号因素有关。
- QUIC(UDP 443)处理不当会造成规律性的加载卡顿。
第一步:确认流量路径
很多「地区不可用」其实是流量根本没走代理。在代理客户端的连接面板中访问 gemini.google.com:
- 显示 DIRECT → 规则没有覆盖,调整规则或临时切换全局模式测试;
- 显示代理节点 → 记下节点所在地区,进入第二步。
对于 API 或 Gemini CLI,在同一终端中测试:
export HTTPS_PROXY=http://127.0.0.1:7897
curl -I https://generativelanguage.googleapis.com
第二步:确认地区
对照 Gemini API 可用地区 和 Gemini 应用的可用地区说明:
- 当前出口地区不在列表中 → 换到列表中的地区;
- 在列表中但仍提示不可用 → 清除站点数据后重试;仍不可用时,可能与账号相关因素有关。
第三步:API 报错对照
| 报错 | 含义 | 处理 |
|---|---|---|
400 FAILED_PRECONDITION + User location is not supported |
出口地区不支持 | 换支持地区的节点,确认程序走代理 |
403 PERMISSION_DENIED |
API Key 权限或项目设置问题 | 检查 API Key 与项目配置 |
429 RESOURCE_EXHAUSTED |
配额或速率限制 | 降低请求频率,查看配额 |
500 / 503 |
服务端错误或过载 | 稍后重试 |
| 连接超时 | 网络问题 | 按第一步、第四步排查 |
错误码的含义以官方故障排查文档为准。
第四步:页面卡顿与 QUIC
如果 Google 页面「能打开但总要卡几秒」,并且你开启了 TUN 模式,很可能是 QUIC 的问题:浏览器先尝试基于 UDP 的 QUIC 连接,节点不支持 UDP 时要等超时才改用 TCP。
在 mihomo(Clash Meta)配置中加入:
rules:
- AND,((NETWORK,UDP),(DST-PORT,443)),REJECT
或者换用支持 UDP 的节点。
第五步:DNS
客户端日志中出现 Google 相关域名解析失败时,参考 DNS 异常排查。
仍然请求失败
如果地区、流量路径、DNS 都正确,但请求仍然经常中断,再从线路稳定性方面考虑,参考 Gemini 稳定机场 与 AI 工具连接超时诊断。
常见问题
换了美国节点,Gemini 还是提示不可用?
先确认浏览器流量确实走了代理(连接面板中不是 DIRECT),并清除站点缓存后重试。如果确认出口正确仍然不可用,可能与 Google 账号的关联国家/地区等因素有关,需要参考 Google 官方说明。
Gemini API 在本地脚本中报地区错误,浏览器却正常?
说明脚本没有走代理。在运行脚本的终端中设置 HTTPS_PROXY,或开启 TUN 模式。
资料来源与数据性质
- 官方资料Gemini API 可用地区
- 官方资料Gemini API 故障排查