Rails Mailer调用URL助手提示No route matches {}问题求助

从你提供的测试结果来看，这个问题主要和Mailer缺少URL生成的必要配置以及路由参数的传递方式有关，咱们一步步来排查修复：

1. 先解决最核心的问题：Mailer未配置默认Host #

Rails的_url助手生成的是完整的绝对URL（包含域名），而Mailer不像Controller那样能从request对象里获取域名信息，所以必须手动配置默认host。

打开对应环境的配置文件（比如config/environments/development.rb或production.rb），添加以下配置：

# 开发环境示例
config.action_mailer.default_url_options = { host: 'localhost', port: 3000 }

# 生产环境示例（替换成你的实际域名）
# config.action_mailer.default_url_options = { host: 'your-production-domain.com' }

配置完成后，重启服务器再测试root_url或pages_url，应该不会再出现No route matches {}的错误了。

2. 处理Locale路由作用域的参数问题 #

从你测试page_url 1时出现的错误missing required keys: [:id]，且系统把1当成了locale参数来看，你的路由里应该有类似这样的Locale作用域配置：

scope '(:locale)', locale: /en|fr/ do
  resources :pages
  root 'home#index'
end

这种情况下，所有路由都要求传入locale参数，但Mailer默认不会自动带上这个参数，导致参数混淆或缺失。你可以用以下几种方式解决：

方式一：在Mailer类中默认传入Locale #

打开你的Mailer类（比如app/mailers/your_mailer.rb），在default方法里添加url_options配置：

class YourMailer < ApplicationMailer
  default from: 'your-email@example.com',
          url_options: { locale: I18n.default_locale } # 用默认Locale，或者动态设置
end

方式二：调用URL助手时明确传入关键字参数 #

避免使用位置参数（容易混淆顺序），改用关键字参数明确指定每个参数：

# 正确的调用方式
page_url(id: 1, locale: :en)
root_url(locale: :en)
pages_url(locale: :en)

方式三：给路由设置默认Locale #

如果允许路由在没有传入Locale时使用默认值，可以修改路由配置：

scope '(:locale)', locale: /en|fr/, defaults: { locale: 'en' } do
  resources :pages
  root 'home#index'
end

这样即使不传入locale参数，Rails也会自动使用默认值，不会报错。

3. 辅助调试：查看完整路由列表 #

如果还是有问题，运行rails routes命令，查看所有路由的详细信息，确认每个路由需要的参数、格式，确保你调用_url助手时传递的参数完全匹配。

比如，查看pages#show对应的路由，确认它的参数要求是page_url(id: ..., locale: ...)还是其他格式，这样能快速定位参数传递的问题。

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