Ruby on Rails应用SSL部署后登出报URI::InvalidComponentError错误

嘿，我之前在Rails项目里用Devise+OmniAuth搭配Nginx SSL时，也碰到过一模一样的错误！问题根源基本都是Rails没正确识别Nginx反向代理后的HTTPS协议，导致Devise生成登出跳转URL或者处理OmniAuth回调时，出现了格式混乱的scheme（比如你看到的: https这种错误组合）。下面是我亲测有效的解决步骤：

1. 给Nginx添加请求头，传递HTTPS协议信息 #

在你的Nginx server配置块里，添加以下proxy_set_header配置，把真实的HTTPS协议信息传递给Rails应用：

proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Port $server_port;

没有这些头的话，Rails会误以为Nginx转发过来的是HTTP请求，生成的URL自然会出现格式错误。

2. 配置Rails信任反向代理的请求头 #

打开Rails的环境配置文件（生产环境改config/environments/production.rb，开发环境改config/environments/development.rb），添加或修改以下配置：

# 信任本地反向代理（若Nginx和Rails不在同一服务器，替换为Nginx的IP/IP段）
config.action_dispatch.trusted_proxies = %w(127.0.0.1/8 ::1)
# 强制所有请求使用HTTPS（可选但推荐，避免混合协议问题）
config.force_ssl = true

trusted_proxies是关键配置，没有它Rails会忽略Nginx传递的X-Forwarded-Proto头，这一步很容易被遗漏！

3. 检查Devise与OmniAuth的URL配置 #

• 视图里不要硬编码登出的绝对URL，比如别写<a href="http://yourdomain.com/users/sign_out">，一定要用Rails路由辅助方法：

  <%= link_to "登出", destroy_user_session_path, method: :delete %>
  

• 打开config/initializers/devise.rb检查OmniAuth配置，回调URL别写死成http://开头的：要么用相对路径，要么用环境变量存储正确的HTTPS地址，比如：

  config.omniauth :github, ENV['GITHUB_KEY'], ENV['GITHUB_SECRET'], callback_url: ENV['GITHUB_HTTPS_CALLBACK']
  

  更省心的方式是直接留空callback_url，让Rails自动根据当前请求协议生成。

4. 重启服务验证 #

修改完Nginx配置后，重启Nginx服务：

sudo systemctl restart nginx

再重启你的Rails应用（比如Puma/Unicorn服务），测试登出功能，应该就能正常工作了！

额外排查小技巧 #

如果问题还没解决，去查看Rails日志（log/production.log），找到登出请求的日志，看看生成的跳转URL是否存在: https这类异常格式。也可以在Rails控制台里测试user_session_url生成的地址，确认是正确的HTTPS链接。

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