使用Google Omniauth时遇IPAddr::InvalidAddressError错误求助

算力阿峰

2026-5-25

解决Google Omniauth登录时的IPAddr::InvalidAddressError问题

首先明确说：Google API完全支持localhost:3000作为开发环境的回调地址，这个不用担心，只要在Google Cloud Console的OAuth客户端设置里正确配置了重定向URI就行。

接下来针对你遇到的IPAddr::InvalidAddressError，大概率是代码中处理IP地址时传入了无效字符串，给你几个排查方向：

检查Omniauth Google策略的配置细节
确认你的Omniauth配置里的redirect_uri（如果手动指定了的话）格式完全正确，比如应该是http://localhost:3000/auth/google/callback，别漏了冒号、写错域名或者路径。很多时候这种错误是因为配置里的地址字符串有语法错误，导致后续IP解析逻辑出错。
排查服务器端的IP获取逻辑
如果你的Rails应用（假设你用的是Rails）配置了config.action_dispatch.trusted_proxies，或者有自定义中间件在处理请求IP，可能会导致Omniauth拿到一个无效的IP字符串（比如空字符串、格式错误的地址）。可以暂时注释掉这类自定义配置，重启服务器后再测试，看错误是否消失。
查看完整错误栈定位触发点
把完整的错误调用栈贴出来（如果有的话），能更精准定位问题。如果错误是来自Omniauth的内部代码，可能是它在尝试解析请求来源IP时收到了无效值；如果是你自己的业务代码触发的，那就要检查你处理IP的地方传入的参数是否正确。
验证Google Cloud Console的重定向URI配置
虽然这个不会直接导致IP解析错误，但确保你在Google Cloud Console的OAuth 2.0客户端ID设置中，已经把http://localhost:3000/auth/google/callback添加到「已授权的重定向URI」列表里。如果没加，可能会触发其他授权错误，但有时候也会间接引发异常，所以确认一下没坏处。

举个简单的正确配置例子（假设是Rails）：

Rails.application.config.middleware.use OmniAuth::Builder do
  provider :google_oauth2, ENV['GOOGLE_CLIENT_ID'], ENV['GOOGLE_CLIENT_SECRET'],
    scope: 'email,profile',
    redirect_uri: 'http://localhost:3000/auth/google/callback' # 确保这个地址完全正确
end

先从这些方向排查，应该能找到问题所在。

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