Rails 6.1项目执行rake routes提示无可用路由任务怎么办

• 该问题与routes.rb是否置空完全无关。正常Rails项目中，哪怕路由文件内容为空，框架也会默认注册routes相关的rake任务；路由内容为空只会导致任务执行后输出空列表，不会让任务本身从可用任务列表中消失。
• 结合你输出的rake --tasks结果交叉验证：当前任务注册表完全缺失路由相关任务的注册项，本质是Rails框架内置的ActionDispatch路由组件的Rake任务加载逻辑没有被触发，不属于路由文件内容异常导致的问题。
• 常见触发该问题的场景：
  • 项目根目录Rakefile被修改时，误删了Rails应用的全局任务加载逻辑，导致仅部分独立引入的任务（如数据库操作、Webpacker相关任务）能正常显示，框架绑定的关联任务没有被注册
  • 自定义初始化脚本/自定义Rake任务中存在未捕获的异常，静默中断了后续框架的任务注册流程
  • 从旧版本Rails升级到6.1的过程中，遗漏了路由任务相关的加载配置

• 第一步：检查项目根目录的Rakefile内容，确认存在以下核心加载逻辑：

  require_relative 'config/application'
  # 这行是Rails加载所有内置任务的核心，绝大多数同类问题都是这行被误删
  Rails.application.load_tasks
  

  缺失该行时补上即可，重新执行rake --tasks就能看到完整的可用任务列表。
• 第二步：通过Rails原生CLI验证路由组件运行状态
  在项目根目录运行bin/rails routes，如果该命令能正常输出路由列表，说明路由组件本身运行完全正常，问题100%出在Rakefile的任务加载流程上。
• 第三步：排查静默初始化异常
  如果执行bin/rails routes也报任务不存在，可带上--trace参数执行rake about，查看应用初始化流程中是否有被捕获的静默异常，导致路由组件没有完成加载。
• 第四步：临时补全任务注册逻辑
  如果因为历史原因不方便直接修改Rakefile，可以在lib/tasks/目录下新建routes.rake文件，写入以下代码强制手动注册路由任务：

  # 手动加载ActionDispatch内置的路由Rake任务
  require 'action_dispatch'
  ActionDispatch::Routing::RoutesInspector.new(Rails.application.routes.routes).add_routes_tasks
  

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