升级Rails+MongoDB应用时调用DatabaseCleaner.clean报BSON字段缺失错误

以下是具体排查方向和解决方案：

1. 校验database_cleaner-mongoid版本兼容性 #

Rails 5.2搭配的Mongoid通常为6.x系列，需确保database_cleaner-mongoid版本与当前Mongoid、Rails版本匹配。旧版本的cleaner可能生成不符合Mongo 3.6+要求的delete命令（该版本对命令格式校验更严格）。

• 在Gemfile中锁定兼容版本：

  gem 'database_cleaner-mongoid', '~> 2.0'
  

• 执行bundle update database_cleaner-mongoid更新依赖。

2. 修正DatabaseCleaner配置方式 #

避免直接调用DatabaseCleaner.clean，需先初始化清理策略，再绑定测试钩子：

# spec/rails_helper.rb
RSpec.configure do |config|
  # 初始化Mongoid清理策略
  config.before(:suite) do
    DatabaseCleaner[:mongoid].strategy = :truncation # 或根据需求选择:deletion
    DatabaseCleaner[:mongoid].clean_with(:truncation)
  end

  # 绑定测试前后的清理逻辑
  config.before(:each) do
    DatabaseCleaner[:mongoid].start
  end

  config.after(:each) do
    DatabaseCleaner[:mongoid].clean
  end
end

未初始化策略直接调用clean，会导致生成的delete命令缺失必要的query字段。

3. 检查Mongoid与MongoDB服务器兼容性 #

• 确认config/mongoid.yml中测试环境的配置正确，使用Mongo 3.6+要求的连接格式（如URI模式）。
• 检查MongoDB服务器的兼容性版本：
  在Mongo Shell中执行：

  db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })
  

  若返回version为3.4，需升级至对应服务器版本（如3.6/4.0）：

  db.adminCommand({ setFeatureCompatibilityVersion: "3.6" })
  

  注：MongoDB 3.7为开发版本，建议切换至稳定版（3.6/4.0/4.4）。

4. 手动模拟清理操作排查 #

在测试环境的Rails Console中执行手动清理，验证是否为驱动问题：

Mongoid.default_session.collections.each do |col|
  next if col.name.start_with?('system.') # 跳过系统集合
  col.delete_many({}) # 必须传入空query对象，不可省略
end

• 若该操作报错：说明Mongoid驱动与Mongo服务器版本不兼容，需调整Mongoid版本。
• 若操作成功：说明database_cleaner-mongoid生成的命令存在问题，需更换版本或提交issue。

5. 临时绕过database_cleaner-mongoid #

若以上方案均无效，可手动实现测试清理逻辑：

# spec/rails_helper.rb
RSpec.configure do |config|
  config.before(:each) do
    Mongoid.default_session.collections.each do |collection|
      next if collection.name.start_with?('system.')
      collection.delete_many({})
    end
  end
end

直接调用Mongoid原生方法确保命令格式正确。

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