升级Rails 7后路由中命名空间约束类无法找到的问题

Rails 7 默认使用 Zeitwerk 作为自动加载器，而 lib 目录默认不在 Zeitwerk 的自动加载路径中。此前的 Rails 版本多使用经典自动加载器，会自动扫描 lib 目录，因此旧代码能正常运行；升级后 Zeitwerk 不会自动加载 lib 下的文件，直接导致找不到 Constraints 模块。

方法1：将lib目录加入自动加载路径（推荐） #

在 config/application.rb 中添加配置，让 Zeitwerk 自动加载 lib 目录下的文件：

# config/application.rb
class Application < Rails::Application
  # ... 其他已有配置
  config.autoload_paths << Rails.root.join('lib')
  # 若需在生产环境也自动加载，补充下面一行（默认生产环境自动加载为关闭状态）
  config.eager_load_paths << Rails.root.join('lib')
end

你的文件结构和命名完全符合 Zeitwerk 的规范：

• 文件路径：lib/constraints/omniauth_callback_constraint.rb
• 常量结构：Constraints::OmniauthCallbackConstraint
  添加配置后无需手动 require，启动应用时 Zeitwerk 会自动加载该约束类。

方法2：手动require约束文件（按需使用） #

如果不想将整个 lib 目录加入自动加载路径，可以在 routes.rb 中手动引入文件，注意使用正确的路径：

# config/routes.rb
require_relative '../lib/constraints/omniauth_callback_constraint'

get '/auth/:provider/callback', to: "oauth_accounts#create_or_update", constraints: Constraints::OmniauthCallbackConstraint.new

也可以使用绝对路径写法：

require "#{Rails.root}/lib/constraints/omniauth_callback_constraint"

此前报错的原因是：直接使用 require 'constraints/omniauth_callback_constraint' 时，lib 不在 Ruby 的 $LOAD_PATH 中，Zeitwerk 无法定位文件；同时 Zeitwerk 会校验文件定义的常量是否与文件名匹配，你的文件定义的是嵌套模块下的类，直接 require 会触发命名校验错误，而使用 require_relative 或绝对路径可绕过该问题。

• 优先选择方法1，统一配置自动加载路径，避免手动管理文件引入，契合 Rails 7 的 Zeitwerk 规范。
• 若仅需加载单个约束文件，使用方法2的正确路径引入即可。

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