阿里云ECS上Rails生产环境控制台无法加载User模型

先还原下你的操作场景：

在阿里云ECS实例 app_danci@iZ2ze599ua4y0nvsppbmjhZ 的 ~/myproject 目录下，执行 rails c -e production 进入Rails 5.1.4生产环境控制台，调用 User.first 和 User.all 均报错：

NameError: uninitialized constant User

针对这个问题，我整理了几个常见的排查方向和解决办法：

1. 先试试手动加载模型 #

Rails生产环境默认开启类缓存，有时候自动加载机制会“偷懒”。你可以在控制台里手动加载User模型试试：

require_relative '../app/models/user'

如果加载后能正常调用User.first，那说明是自动加载的问题，继续往下看其他方案。

2. 检查模型文件的命名和路径 #

Rails是个“约定大于配置”的框架，模型类名User必须对应app/models/user.rb这个文件——文件名得是小写单数，不能写成users.rb或者User.rb。先确认这个文件存在，并且路径和文件名都符合要求。

3. 干掉Spring预加载器的缓存 #

你控制台里显示Running via Spring preloader，Spring有时候会缓存旧的应用状态，比如你刚添加的User模型可能没被它识别到。先关掉Spring再重启控制台：

spring stop && rails c -e production

这个方法经常能解决一些莫名其妙的加载问题。

4. 检查生产环境的配置 #

打开config/environments/production.rb，看看这两个配置项：

• config.eager_load：生产环境默认应该是true，如果被改成false，模型不会被预加载，就会出现找不到常量的错误。
• config.autoload_paths：确保里面包含了app/models目录，不过默认情况下Rails已经配置好了，除非你手动修改过这个配置。

5. 确认模型类的定义正确 #

最后再检查下app/models/user.rb里的代码，确保类名拼写正确，是这样的格式：

class User < ApplicationRecord
  # ... 模型的其他代码
end

别把类名写成user（小写）或者Users（复数），这些都会导致Rails识别不到。

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