Rails控制器访问自定义类报错：未初始化常量GoogleCalWrapper

这个问题我之前集成第三方API的时候也踩过坑！核心原因是Rails 5及以后的版本默认不会把lib目录加入自动加载路径，所以你的EventsController找不到GoogleCalWrapper这个常量。下面给你几个靠谱的解决办法：

方法1：把lib目录加入自动加载/预加载路径 #

打开config/application.rb，在class Application < Rails::Application代码块里添加这两行代码：

config.autoload_paths << Rails.root.join('lib')
config.eager_load_paths << Rails.root.join('lib')

• autoload_paths适配开发环境，会在需要时自动加载文件，修改后无需重启服务器即可生效（刷新页面就行）
• eager_load_paths适配生产环境，启动时会预加载指定路径下的所有文件，避免运行时加载带来的性能损耗

方法2：手动require文件（生产环境更稳妥的方案） #

如果不想修改自动加载路径，可以直接在需要用到类的地方手动引入文件：
在EventsController的最顶部添加：

require 'google_cal_wrapper'

或者更规范的做法：在config/initializers目录下新建lib_loader.rb文件，写入：

require Rails.root.join('lib', 'google_cal_wrapper')

这样Rails启动时就会加载这个类，整个应用都能直接访问。

方法3：检查文件名和类名的一致性（最容易忽略的细节） #

Rails自动加载严格遵循蛇形文件名对应驼峰类名的规则，一定要确保：

• 文件名是google_cal_wrapper.rb（全小写，下划线分隔单词）
• 类名是GoogleCalWrapper（每个单词首字母大写，驼峰式命名）
  如果文件名和类名不匹配，就算路径配置正确也会找不到常量！

快速调试小技巧 #

可以先在Rails控制台里验证：

rails c

然后依次输入：

require 'google_cal_wrapper'
GoogleCalWrapper # 看是否会抛出未初始化常量的错误

如果控制台能正常识别这个类，那问题大概率出在控制器的加载逻辑上；如果控制台也报错，那基本是文件名/类名不匹配或者路径配置有误。

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