Rails中Geocoder gem返回查询超限错误的排查求助

碰到这种明明没怎么调用API却触发「over query limit」的情况，确实挺闹心的，咱们可以从这几个方面逐一排查：

• 先确认API密钥的配置是否真的生效
  看你给出的Geocoder配置里，重复写了两次api_key——第一次是api_key: nil，后面才是真实密钥。虽然Ruby哈希里后面的键会覆盖前面的，但还是得确认配置是否正确加载。可以打开Rails控制台执行：

  puts Geocoder.config.api_key
  

  如果输出的不是你设置的密钥，那说明配置没生效，可能是初始化文件的加载顺序有问题，或者语法错误导致配置没被正确读取。

• 检查Google Cloud控制台的API状态与配额
  登录你的Google Cloud项目控制台，重点看这几个点：

  • 确认Geocoding API是否已经启用（有时候可能以为开了，但实际没激活）；
  • 查看API的配额页面，看看当日的请求配额是否真的已经耗尽——说不定是之前的测试或者密钥被误用（比如不小心泄露到公共仓库）导致配额被用掉；
  • 检查密钥的IP限制设置，如果你的本地IP不在允许列表里，Google可能会拒绝请求，有时候错误信息会误报成超限。

• 验证缓存配置是否正常工作
  你配置了Redis作为缓存，但得确认缓存是否真的在生效。如果缓存没起作用，重复请求都会直接打向Google API，很容易触发限制。可以在控制台做个小测试：

  # 第一次请求地址
  Geocoder.coordinates("25 Main St, Cooperstown, NY")
  # 立即第二次请求同一个地址
  Geocoder.coordinates("25 Main St, Cooperstown, NY")
  

  如果第二次还是弹出超限错误，说明缓存没工作。先检查Redis服务是否正常运行，控制台执行Redis.new.ping，如果返回PONG才是正常的。

• 排查是否有其他主体在使用同一个密钥
  哪怕你本地没调用，这个密钥可能被其他环境（比如测试服务器、同事的项目）共用了，导致总请求量超限。可以去Google Cloud的API使用报告里查看请求的来源IP，看看有没有陌生IP在调用你的密钥。

• 用curl直接测试API，确认错误信息的准确性
  有时候Google的错误提示可能有误导，比如权限不足（密钥没有Geocoding API的访问权限）也可能被返回成超限。可以用curl直接调用API试试：

  curl "https://maps.googleapis.com/maps/api/geocode/json?address=25+Main+St,+Cooperstown,+NY&key=你的API密钥"
  

  看返回的具体JSON错误信息，比如如果是REQUEST_DENIED，那问题可能出在权限或者IP限制上，而不是真的超限。

• 添加Geocoder本地速率限制（可选）
  短时间内频繁发起请求也会触发Google的速率限制，你可以在Geocoder配置里加上本地的请求限制，避免自己的代码不小心刷爆配额：

  Geocoder.configure(
    # 保留你原有的配置...
    rate_limit: 10,        # 限制每分钟最多10次请求
    rate_limit_per_second: 1  # 每秒最多1次请求
  )
  

内容的提问来源于stack exchange，提问作者Rene Chan