Ruby on Rails应用重置密码链接域名缺失点导致链接失效问题

嘿，这个问题我之前帮不少Rails开发者排查过——密码重置邮件里的链接要么少了点变成subdomaindomain.com，要么域名部分写错成subdomain.domaincom，大概率是域名拼接逻辑的配置问题，咱们一步步来定位解决：

1. 检查环境配置里的default_url_options #

Rails发送邮件时的默认URL配置在config/environments/下的对应环境文件（比如production.rb）里，这里是最容易出错的地方：

• 错误写法（会导致subdomaindomain.com）：

  config.action_mailer.default_url_options = {
    host: "#{ENV['SUBDOMAIN']}#{ENV['DOMAIN']}", # 漏了中间的`.`分隔符
    protocol: 'https'
  }
  

• 正确写法：

  config.action_mailer.default_url_options = {
    host: "#{ENV['SUBDOMAIN']}.#{ENV['DOMAIN']}", # 明确用`.`分隔子域名和主域名
    protocol: 'https'
  }
  

如果是多租户应用（每个用户/租户对应不同子域名），不能在环境配置里写死host，要在发送邮件时动态传入参数。

2. 排查Devise的配置（如果用了Devise） #

大部分Rails项目用Devise处理身份验证，密码重置邮件是Devise自带的，这时候要检查Devise的初始化配置：

• 在config/initializers/devise.rb里，确保action_mailer_default_url_options的host拼接正确：

  config.action_mailer_default_url_options = { host: "#{ENV['SUBDOMAIN']}.#{ENV['DOMAIN']}" }
  

• 多租户场景下，需要重写Devise的邮件器来动态设置host：
  创建自定义邮件器：

  # app/mailers/devise_mailer.rb
  class DeviseMailer < Devise::Mailer
    def reset_password_instructions(record, token, opts={})
      # 根据用户关联的子域名动态生成host
      opts[:host] = "#{record.subdomain}.yourdomain.com"
      super
    end
  end
  

  然后在devise.rb里指定使用这个自定义邮件器：

  config.mailer = 'DeviseMailer'
  

3. 验证环境变量的正确性 #

有时候问题出在环境变量本身：

• 检查ENV['DOMAIN']是不是正确设置成了domain.com（而不是手滑写成domaincom）
• 在Rails控制台里打印拼接后的host，确认输出符合预期：

  Rails.logger.info "#{ENV['SUBDOMAIN']}.#{ENV['DOMAIN']}"
  # 预期输出：subdomain.domain.com
  

4. 检查自定义邮件模板的硬编码 #

如果你自定义了密码重置邮件模板，要确认模板里的URL拼接逻辑：

• 错误写法（漏了.）：

  <%= "https://#{@user.subdomain}#{ENV['DOMAIN']}/password/edit?token=#{@token}" %>
  

• 正确写法：

  <%= "https://#{@user.subdomain}.#{ENV['DOMAIN']}/password/edit?token=#{@token}" %>
  

或者直接用Rails提供的路由辅助方法更稳妥，避免手动拼接出错：

<%= edit_password_url(@user, reset_password_token: @token) %>

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