Rails 报 No route matches,通常说明请求已经进入 Rails,但路由表里没有一条规则同时匹配请求方法、路径和约束。先不要改 controller,先把“请求到底是什么、路由表里有什么”对齐。
先确认三件事:请求方法(GET/POST/PATCH)、完整路径(含前缀、版本号、尾斜杠),以及部署方式是否在子路径下。然后用 bin/rails routes 过滤目标路径,确认是否存在对应 Verb 与 Controller#Action。若路由表有记录但请求仍 404,重点查通配路由顺序、constraints、引擎挂载点和前置代理;改完后用 console 的 app.get 或本地 curl 验证是否从 RoutingError 变为进入 controller。
先确认当前场景和目标
No route matches 是 ActionController::RoutingError,错误信息通常带方法和路径,例如 No route matches [GET] '/api/v1/users/42'。这个报错发生在路由匹配阶段,和 controller 里的业务逻辑无关;先把它当成“请求地址与路由表对不上”处理。需要先确认:请求方法是否和 routes.rb 里定义的一致;路径是否包含命名空间、版本号、资源复数形式和可选的 format 后缀;应用是否部署在反向代理的子路径下;以及当前环境的路由文件是否确实被加载。
如果日志里只有 RoutingError,没有 Processing by ...,说明没有命中任何路由。相反,如果已经出现 Processing by 再报错,问题就不在路由匹配,应该转去查 controller 或参数。这个区分能省掉很多无效修改。
按这个顺序处理
- 从日志或客户端拿到完整请求:方法、路径、查询参数、Host。不要只看浏览器地址栏,API 客户端可能自动加了前缀或后缀。
- 在项目根目录过滤路由表。新版 Rails 通常用 bin/rails routes;老项目可能是 bundle exec rake routes,按本环境确认。
- 核对输出中的 Verb、URI Pattern、Controller#Action 三列是否和请求一致。路径参数段(如 :id)必须有值,复数资源名不要写成单数。
- 检查 routes.rb 中目标路由是否被前面的通配路由截住,例如 get ':controller/:action/:id' 或 match '*path'。这类规则应放在文件末尾,并加 constraints 限制。
- 检查 constraints:subdomain、format、id 正则、请求头判断都可能让路由“看起来存在但不匹配”。
- 如果用了 mount 引擎或 draw 拆分路由文件,确认挂载点和加载条件。
# 过滤路由,先看是否存在目标路径
bin/rails routes -g users
# 按 controller 过滤
bin/rails routes -c users
# 控制台直接识别路径,不经过外部服务
bin/rails runner 'begin; p Rails.application.routes.recognize_path(%q(/api/v1/users/42), method: :get); rescue => e; puts e.class; puts e.message; end'
如果 recognize_path 能返回 controller 和 action,说明路由表本身有这条规则,问题更可能出在请求方法、Host/子域、前置代理或中间件提前返回。此时用本地 curl 直连应用端口,对比经过代理时的差异。
改完后怎么验证
验证分两层。第一层看路由表:bin/rails routes 的输出中应出现目标行,Verb 和 URI Pattern 与请求完全对应。第二层看请求是否真正进入 controller。
# 本地启动服务后直接请求,观察状态码和响应
curl -i http://127.0.0.1:3000/api/v1/users/42
# 在 rails console 里用集成会话请求,适合快速确认路由
app.get '/api/v1/users/42'
app.response.status
app.response.body[0, 300]
预期信号是:开发日志从 ActionController::RoutingError 变为 Processing by UsersController#show,或者 app.get 返回 200/302 而不是 404。若仍是 404,但 routes 输出里明明有对应行,优先回头查请求前缀、Host、请求方法和 constraints,而不是继续改 controller。生产环境修改 routes.rb 后通常需要重启应用进程,具体按部署方式确认。
容易忽略的边界
路由文件里可能有环境条件,例如只在 development 加载某些 draw 或调试路由;上线后这些路由不存在是预期行为,不要在生产打开调试路由来“修复”404。反向代理把 /myapp 前缀原样转发给 Rails 时,请求路径会多一段,路由表里却没有这个前缀,需要在代理层剥离或按环境配置相对根路径。前置服务器或中间件直接返回 404 时,Rails 日志里可能没有 RoutingError,这时要看代理日志而不是路由表。
不建议长期用 match '*path' 兜底来消除报错,它会把拼写错误、方法错误一起吞掉,后续更难定位。更稳的回退方式是先加一条最小显式路由,确认请求能到达 Rails,再逐步补回命名空间、constraints 和格式限制;如果怀疑是子路径或 Host 问题,在日志中打印 request.path 和 request.host,与 curl 直连结果对比后再改配置。