Rails加载app/lib目录模块报错 如何正确引入到控制器

加载失败是三个核心问题导致的：自动加载路径配错、文件命名/存放不符合Rails自动加载规则、引入的常量名和实际定义的不匹配，按下面步骤调整就能解决：

1. 修正自动加载路径配置 #

你当前配置里加的是项目根目录下的lib文件夹（#{config.root}/lib），但你的模块是存放在app/lib目录下，路径差了一层app，Rails根本扫描不到对应文件。
另外你用Dir["#{config.root}/lib/**/"]递归添加所有子目录的写法是错的，Rails7默认用Zeitwerk做自动加载，会自动根据目录层级映射常量，手动加所有子目录反而会引发常量冲突。
把application.rb里原来的三行autoload_paths配置全删掉，换成这一行：

config.autoload_paths << Rails.root.join('app/lib')

提示：Rails 6+ 版本其实会自动把app目录下所有存在的一级目录加入自动加载路径，如果你是新建的app/lib目录，重启服务后不写这行配置也能识别，但手动加上更稳妥。

2. 按Zeitwerk规范调整文件命名和存放位置 #

Zeitwerk的核心规则是文件路径和常量名严格一一对应，差一个字符都会加载失败：

• 如果你要使用的类是A::B::C，那对应的文件必须存放在app/lib/a/b/c.rb路径下：
  • 顶级模块A对应目录app/lib/a/
  • A下的子模块B对应目录app/lib/a/b/
  • A::B::C类对应文件app/lib/a/b/c.rb
• 如果你要在控制器里include Operator，那Operator模块对应的文件必须是app/lib/operator.rb，文件里直接定义顶级模块Operator，不能套多余的、和路径不匹配的外层模块。

你贴出来的A::B::C类代码和控制器里写的include Operator完全对应不上，要么是你漏贴了Operator模块的代码，要么是命名/路径放错了，按上面的规则对齐就行。

3. 控制器里正确引入 #

不需要手动写require（尤其是不要写require './app/lib/api'这种带相对路径的写法，生产环境会因为工作目录变化直接报错），只要路径和命名符合规范，Rails会自动加载对应常量：

• 如果是调用类方法，直接在动作里用全限定名调用即可，不需要include：

  class SchemasController < ApplicationController
    def index
      # 直接调用，不需要额外引入
      @result = A::B::C.where(params.permit(:xxx, :yyy))
    end
  end
  

• 如果是要把模块里的方法作为实例方法混入控制器，确认模块名和文件匹配后直接include即可：

  class SchemasController < ApplicationController
    # 对应app/lib/operator.rb中定义的Operator模块
    include Operator
  end
  

排查小技巧 #

• 改完application.rb的配置一定要重启Rails服务，配置类修改开发环境不会自动重载
• 如果还是提示常量找不到，打开rails console执行puts ActiveSupport::Dependencies.autoload_paths，确认输出里包含app/lib的完整路径
• 不要在lib目录下的文件里写多余的嵌套模块，比如app/lib/operator.rb里不要套module A; module B; module Operator; end; end; end这种和路径不匹配的结构，一定会加载失败

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