使用Rspec+SimpleCov无法在coverage/index.html展示UTC覆盖率（Forest Admin环境）

核心原因推测 #

Forest Admin的代码生成机制与自动加载逻辑，会改变Rails项目的代码加载顺序，导致SimpleCov无法在代码加载前完成初始化，进而漏统计大部分业务代码。只有test_setup_db.rake被统计，是因为Rake任务的加载流程不受Forest的自动加载影响。

具体解决方案 #

1. 强制SimpleCov在所有代码加载前启动 #

把SimpleCov的初始化代码放在spec_helper.rb的最顶部，确保在Rails、Forest任何代码加载前完成覆盖率追踪的初始化：

# spec/spec_helper.rb
# 必须是文件的第一部分代码
require 'simplecov'
SimpleCov.start 'rails' do
  # 明确指定需要统计的业务代码目录
  add_group 'Controllers', 'app/controllers'
  add_group 'Models', 'app/models'
  add_group 'Services', 'app/services'
  add_group 'Lib', 'lib/'
  
  # 排除Forest自动生成的代码（如果不需要统计这些自动生成的文件）
  add_filter 'app/forest/'
  # 排除测试相关文件
  add_filter 'spec/'
  add_filter 'test/'
end

# 之后再加载Rails环境与RSpec依赖
require_relative '../config/environment'
require 'rspec/rails'
# ... 其他RSpec配置代码

2. 验证测试用例是否实际触发业务代码执行 #

有些Forest Admin相关的测试可能过度依赖Stub/Mock，导致实际业务代码并未被加载或执行。可以：

• 运行单个测试文件，比如bundle exec rspec spec/controllers/your_controller_spec.rb，查看coverage是否统计到对应的控制器文件
• 在测试用例中避免完全Mock业务逻辑，保留部分实际代码调用，确保代码被加载执行

3. 检查SimpleCov的加载日志 #

启动测试时添加VERBOSE=1参数，查看SimpleCov的加载详情，确认是否误排除了业务代码：

VERBOSE=1 bundle exec rspec

日志中会显示SimpleCov追踪的所有文件，若你的业务代码不在列表中，说明需要调整add_group或add_filter规则。

4. 调整Rails测试环境的自动加载设置 #

Forest可能延迟加载部分代码，在config/environments/test.rb中添加以下配置，确保测试环境下代码被及时加载：

config.eager_load = true
config.autoload_paths += %W(#{config.root}/app/services #{config.root}/lib)

5. 排除其他Gem的干扰 #

临时禁用webmock或mocha，测试是否是这些Gem影响了代码加载与覆盖率统计。如果禁用后恢复正常，再针对性调整这些Gem的配置。

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