升级Mongoid7.0后报uninitialized constant Mongoid::Relations错误

• 项目版本升级基线：Rails 5.2 → 6.0，Mongoid 6.0 → 7.0
• 升级后执行rake任务直接终止，抛出如下错误：

rake aborted!
NameError: uninitialized constant Mongoid::Relations
/mnt/src/lib/tasks/encrypted_fields_migration.rake:2:in `<top (required)>'
/usr/local/bundle/gems/railties-6.0.5/lib/rails/engine.rb:660:in `block in run_tasks_blocks'
/usr/local/bundle/gems/railties-6.0.5/lib/rails/engine.rb:660:in `each'
/usr/local/bundle/gems/railties-6.0.5/lib/rails/engine.rb:660:in `run_tasks_blocks'
/usr/local/bundle/gems/railties-6.0.5/lib/rails/application.rb:518:in `run_tasks_blocks'
/usr/local/bundle/gems/railties-6.0.5/lib/rails/engine.rb:459:in `load_tasks'
/usr/local/bundle/gems/railties-6.0.5/lib/rails/railtie.rb:190:in `public_send'
/usr/local/bundle/gems/railties-6.0.5/lib/rails/railtie.rb:190:in `method_missing'
/mnt/src/rakefile:9:in `<top (required)>'

• 触发报错的代码段：

module Queries
  EMBEDDED_TYPES = [
    Mongoid::Relations::Embedded::Many,
    Mongoid::Relations::Embedded::One,
  ]
  # ... 其余逻辑
end

这是Mongoid大版本升级的不兼容变更导致的：Mongoid 6.x版本中所有关联关系相关的逻辑都放在Mongoid::Relations命名空间下，7.0版本官方对这部分模块做了重构，整个关联相关的命名空间统一调整为Mongoid::Association，旧的Mongoid::Relations常量已经被彻底移除，所以代码引用旧路径时会抛出未初始化常量的错误。

直接将代码中引用旧命名空间的常量替换为7.0版本对应的新路径即可，修改后的代码如下：

module Queries
  EMBEDDED_TYPES = [
    Mongoid::Association::Embedded::Many,
    Mongoid::Association::Embedded::One,
  ]
  # ... 其余逻辑保持不变
end

修改完成后建议全局搜索项目中所有Mongoid::Relations的引用，统一替换为对应新路径，避免其他业务代码、rake任务里存在同样的兼容问题。

• 跨大版本升级Ruby gem遇到uninitialized constant类报错时，优先查阅对应gem的官方升级说明，重点关注「不兼容变更」章节中关于命名空间调整、类名修改的内容
• 如果找不到对应文档，可以在本地执行bundle show mongoid找到gem的本地安装目录，进入lib文件夹下搜索对应的类文件名，直接确认真实存在的命名空间路径
• 修复单处问题后做全局检索，把同类型的旧写法一次性替换完，避免后续运行其他逻辑时触发同样的报错

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