Rails应用无法从lib加载自定义AppConfig配置的问题求助

问题重现 #

我在lib目录定义了如下配置模块：

# lib/app_config.rb
module AppConfig
  mattr_accessor :title

  def self.configure
    yield self
  end
end

并在初始化文件中完成配置：

# config/initializers/app_config.rb
AppConfig.configure do |config|
  config.title = "WOW"
end

在终端控制台执行puts AppConfig.title能正常输出"WOW"，但在控制器中调用时：

# app/controllers/application_controller.rb
class ApplicationController < ActionController::Base
  def index
    render json: { title: AppConfig.title }
  end
end

接口返回结果却是{ title: null }。

问题原因 #

核心原因是lib目录下的模块未被Rails正确自动加载：

• Rails默认自动加载路径规则中，lib目录不属于默认自动加载范围（尤其是开发环境）。控制台环境中模块可能被临时加载，但Web请求的进程/线程环境里，AppConfig模块会被重新初始化，而初始化文件的配置代码仅在应用启动时执行一次，导致控制器中的AppConfig实例未被赋值。
• 开发环境下Rails的代码热重载机制，不会自动监控lib目录的文件变更，导致模块加载状态不一致。

解决方案 #

方案1：配置自动加载路径 #

在config/application.rb中把lib目录加入自动加载和预加载路径：

# config/application.rb
module YourAppName
  class Application < Rails::Application
    # ...其他配置
    config.autoload_paths << Rails.root.join('lib')
    config.eager_load_paths << Rails.root.join('lib')
  end
end

修改后重启服务器即可生效，该方案适配所有环境，不影响开发效率。

方案2：手动require模块 #

在初始化文件开头手动引入AppConfig模块，确保配置前模块已被加载：

# config/initializers/app_config.rb
require Rails.root.join('lib/app_config')

AppConfig.configure do |config|
  config.title = "WOW"
end

此方案无需修改全局自动加载配置，适合仅需加载单个模块的场景。

方案3：开启预加载（开发环境慎用） #

在config/environments/development.rb中开启预加载：

config.eager_load = true

预加载会在应用启动时加载所有需要的文件，确保配置生效，但开发环境下开启后，修改代码必须重启服务器，会降低开发效率，仅建议临时调试使用。

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