Rails中lib目录自动加载失败及常量循环依赖问题

一、先搞定lib目录的自动加载配置 #

首先得明确你的Rails版本——不同版本的自动加载机制差异很大，这也是很多配置不生效的核心原因：

1. Rails 5.2+（Zeitwerk自动加载器）
   如果你用的是较新版本的Rails，默认采用Zeitwerk，它对目录结构和命名空间的匹配要求更严格：

   • 第一步：确保类/模块命名和文件结构完全对应。比如你的lib/docket/practice_factory/factory.rb里的类必须写成：

     module Docket
       module PracticeFactory
         class Factory
           # 你的业务代码
         end
       end
     end
     

   • 第二步：在config/application.rb里用更可靠的路径写法配置自动加载：

     config.autoload_paths << Rails.root.join('lib')
     # 如果需要递归加载lib下所有子目录，改成：
     # config.autoload_paths += Dir[Rails.root.join('lib', '**/')]
     

   • 关键提醒：修改完配置必须重启Rails服务器，自动加载路径的变更只有重启后才会生效，这是很多人容易忽略的点。

2. Rails 4及以下（经典自动加载器）
   老版本的话，你的配置思路没问题，但路径拼接可以更严谨，避免字符串拼接的潜在问题：

   config.autoload_paths += [
     Rails.root.join('app/models/ckeditor'),
     Rails.root.join('lib')
   ]
   

   同样，别忘了重启服务器。

二、解决循环依赖错误 #

出现Circular dependency detected while autoloading constant，说明Factory和PaFactory两个类互相引用了（比如A文件里引入了B，B文件又反过来引入了A）。可以用这几个方法解决：

• 延迟类引用：不要在文件顶部直接引入对方，而是在需要用到的方法内部再调用。比如：

  # 在factory.rb里
  module Docket
    module PracticeFactory
      class Factory
        def create_pa_instance
          # 不在顶部写 require_relative 'pa_factory'，而是在这里直接调用类
          PaFactory.new(...)
        end
      end
    end
  end
  

• 用require_dependency替代普通require：Rails提供的require_dependency会让自动加载器正确处理依赖关系，避免循环问题。比如在其中一个文件顶部添加：

  require_dependency 'docket/practice_factory/pa_factory'
  

• 重构代码解耦：如果出现循环依赖，往往说明代码结构有优化空间——可以把两个类共用的逻辑抽成独立模块，让两个类都引用这个模块，而非互相引用。

最后检查要点 #

• 确认文件名和类名的大小写匹配（Rails自动加载对大小写敏感，比如PaFactory对应pa_factory.rb是正确的）
• 检查有没有拼写错误：比如命名空间写错、文件名打错这类低级问题
• 再次确认：重启服务器！

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