Rails 5.2升级至6.0迁移命名空间问题：未初始化常量错误

我之前也碰到过一模一样的问题，这种“迁移里找不到模型但控制台正常”的情况，核心原因在于Rails迁移和控制台的自动加载逻辑差异——控制台启动时会自动加载（或按需触发加载）所有应用模型及依赖，但迁移运行在一个更受限的上下文里，自动加载的触发时机和路径都不一样。你遇到的“先调用其他模型再用Customer就正常”，本质是其他模型的加载触发了某个共享依赖（比如错误提示里的Querier），间接补全了Customer需要的常量。

下面是具体的排查和解决步骤：

• 手动强制加载模型及其依赖
  如果必须在迁移里使用模型，可以直接手动加载模型文件，绕过自动加载的不确定性。在迁移代码的开头添加：

  # 加载Customer模型
  require_dependency Rails.root.join('app/models/customer.rb').to_s
  # 如果Customer依赖Querier这类常量，也提前加载
  require_dependency Rails.root.join('app/models/querier.rb').to_s
  

  这样能确保模型和它的依赖都被明确加载，不会出现找不到常量的问题。

• 检查模型命名与文件结构是否符合Rails约定
  确认你的Customer模型文件是app/models/customer.rb，且模型类没有嵌套在未正确声明的命名空间里。比如如果模型是Admin::Customer，那文件必须放在app/models/admin/customer.rb，迁移里调用时也得写全命名空间Admin::Customer，不然Rails找不到对应的常量。

• 尽量避免在迁移中直接使用模型（官方推荐方案）
  Rails官方其实不建议在迁移里直接用ActiveRecord模型——因为模型代码会随着业务迭代修改（比如加验证、回调、关联），旧迁移可能因为模型代码变化而执行失败。如果只是要操作数据，更安全的方式是直接用SQL或者ActiveRecord::Base.connection：

  # 替代 Customer.all 的写法
  customers = ActiveRecord::Base.connection.select_all("SELECT * FROM customers")
  

  这种方式完全绕过模型加载问题，也更稳定。

• 检查开发环境的自动加载配置
  确认config/environments/development.rb里的config.autoload_paths包含了app/models（默认是包含的，但如果有自定义路径可能需要调整）。另外，开发环境下config.cache_classes默认是false，这会导致自动加载时机和生产环境不同，迁移运行时可能受此影响。

关于错误里的Querier提示 #

错误信息里提到了Customer (call 'Customer.connection' to establish a connection)::Querier，这说明Customer模型内部肯定引用了Querier这个常量，但迁移环境下没加载它。当你调用MyOtherThing.all时，MyOtherThing的加载可能触发了Querier的加载（比如MyOtherThing也依赖这个常量），所以后续Customer.all就能正常运行。你可以检查Customer模型的代码，看看是不是有include Querier或者直接使用Querier的地方，然后在迁移里提前加载这个常量就行。

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