在Rails作用域中使用devise_for时Devise邮件URL生成问题

算力阿峰

2026-5-27

解决Rails API + Devise邮件URL配置问题

我来帮你搞定这个Devise邮件URL的问题——毕竟当Rails只做JSON API后端时，默认的Devise邮件链接确实会踩坑。咱们一步步来：

核心问题分析

默认情况下，Devise生成的确认邮箱、重置密码这类链接，会指向Rails的常规路由，但你的Devise被限制在/api路径下且只处理JSON请求，直接用默认链接要么路径不对，要么用户点击后会下载JSON文件，体验很差。所以咱们要做两件事：要么调整链接指向API并确保格式正确，要么更合理地让链接指向前端页面，由前端调用API完成操作（推荐后者）。

1. 让邮件链接指向前端（推荐方案）

因为用户最终是在前端操作，所以邮件里的链接应该跳转到前端的对应页面，再由前端调用API完成验证/重置操作：

第一步：生成Devise邮件模板

先把Devise默认的邮件模板拉到本地，方便修改：

rails generate devise:views users

生成后，模板文件会在app/views/users/mailer/目录下。

第二步：修改邮件模板中的链接

比如打开confirmation_instructions.html.erb（确认邮箱的模板），把默认的Rails链接改成前端地址，带上验证token：

<p>欢迎 <%= @email %>！</p>

<p>你可以通过下方链接确认你的账号：</p>

<p><%= link_to '确认我的账号', "#{ENV['FRONTEND_URL']}/confirm-email?confirmation_token=#{@token}" %></p>

这里的FRONTEND_URL是你的前端域名（比如http://localhost:3001），可以在Rails的环境变量里配置（比如.env文件）。

同理，修改重置密码的模板password_reset_instructions.html.erb：

<p>你好 <%= @email %>！</p>

<p>有人请求修改你的密码，你可以通过下方链接操作：</p>

<p><%= link_to '修改我的密码', "#{ENV['FRONTEND_URL']}/reset-password?reset_password_token=#{@token}" %></p>

第三步：前端调用API完成操作

前端拿到URL里的confirmation_token或reset_password_token后，调用对应的API接口：

确认邮箱：POST请求到/api/users/confirmation，参数带上confirmation_token
重置密码：PUT请求到/api/users/password，参数带上reset_password_token和新密码

2. 自定义Devise API控制器确保JSON响应

默认的Devise控制器已经支持JSON，但你可以自定义控制器来统一返回格式，避免默认的HTML响应：

比如创建app/controllers/api/confirmations_controller.rb：

class Api::ConfirmationsController < Devise::ConfirmationsController
  skip_before_action :require_no_authentication
  skip_before_action :authenticate_user!

  # 发送确认邮件的接口
  def create
    super do |resource|
      if resource.errors.empty?
        render json: { message: '确认邮件已发送' }, status: :ok
      else
        render json: { errors: resource.errors.full_messages }, status: :unprocessable_entity
      end
    end
  end

  # 确认邮箱的接口
  def show
    super do |resource|
      if resource.errors.empty?
        render json: { message: '账号确认成功' }, status: :ok
      else
        render json: { errors: resource.errors.full_messages }, status: :unprocessable_entity
      end
    end
  end
end

同样，你可以自定义passwords_controller.rb来处理重置密码的JSON响应。

然后更新路由，指定自定义的控制器：

Rails.application.routes.draw do
  scope :api, module: :api, constraints: { format: 'json' } do
    devise_for :users, controllers: {
      confirmations: 'api/confirmations',
      passwords: 'api/passwords'
      # 其他需要自定义的控制器，比如registrations、sessions等
    }
  end
end

3. 跨域配置（如果前后端域名不同）

如果你的前端和Rails API不在同一个域名下，需要配置CORS来允许跨域请求：

添加rack-cors gem到Gemfile：

gem 'rack-cors'

运行bundle install后，创建config/initializers/cors.rb：

Rails.application.config.middleware.insert_before 0, Rack::Cors do
  allow do
    origins ENV['FRONTEND_URL'] # 比如 'http://localhost:3001'
    resource '*',
      headers: :any,
      methods: [:get, :post, :put, :patch, :delete, :options, :head]
  end
end

备选：直接让邮件链接指向API（不推荐）

如果非要让邮件链接直接调用API，需要配置Action Mailer的默认URL参数，确保生成的链接包含/api前缀和JSON格式：
在config/environments/development.rb和config/environments/production.rb里添加：

config.action_mailer.default_url_options = { host: 'your-domain.com', path: '/api', format: :json }

但这样用户点击链接后会下载JSON文件，体验不好，所以还是推荐前端跳转的方案。

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

在Rails作用域中使用devise_for时Devise邮件URL生成问题

核心问题分析 #

1. 让邮件链接指向前端（推荐方案） #