Rails项目配置Sorbet执行Tapioca命令遇多类错误求助

一、bundle exec tapioca init 相关错误 #

1. uninitialized constant ActsAsTenant::Sidekiq #

• 先确认项目是否实际用到 acts_as_tenant 的 Sidekiq 集成：
  • 如果没用，找到触发该常量加载的代码（比如初始化文件、Sidekiq 配置段），用 if defined?(Sidekiq) 包裹相关逻辑，避免 Tapioca 扫描时触发未初始化的常量。
  • 如果确实需要该集成，检查 Gemfile 是否添加了 acts_as_tenant-sidekiq，执行 bundle install 完成安装。
• 若上述方法无效，可在 config/tapioca.rb 中添加排除规则，跳过该常量的扫描：

  Tapioca.configure do |config|
    config.dsl_excludes << "ActsAsTenant::Sidekiq"
  end
  

2. cannot load such file -- backburner (LoadError) #

• 先排查依赖来源：执行 bundle dependency backburner，查看是哪个 gem 引入了 backburner。
• 如果项目不需要这个依赖：
  • 若依赖来自某个 gem 的可选功能，找到对应 gem 的配置项，禁用 backburner 相关模块。
  • 在 config/tapioca.rb 中添加跳过加载的配置：

    Tapioca.configure do |config|
      config.require_skip << "backburner"
    end
    

二、bin/tapioca dsl 中 credentials 相关错误 #

触发 undefined method 'api_token' for nil:NilClass 是因为 Tapioca 运行时，当前环境的 Rails.application.credentials.esignatures 为 nil，解决方式：

• 确保当前运行环境的 credentials 文件配置完整：
  • 比如开发环境下，生成或编辑 config/credentials/development.yml.enc，添加 esignatures: { api_token: "dummy_token" }（用占位符即可，无需真实值）。
• 修改控制器代码，避免直接调用 nil 对象的方法：
  • 改用 dig 方法安全取值：Rails.application.credentials.dig(:esignatures, :api_token)，即使 esignatures 不存在也不会报错。
  • 或者用条件判断包裹：

    if Rails.application.credentials.respond_to?(:esignatures)
      @api_token = Rails.application.credentials.esignatures.api_token
    end
    

• 临时方案：在 Tapioca 运行时设置环境变量模拟 credentials，或者在控制器中用 T.unsafe 包裹相关代码（仅用于扫描阶段，不影响业务逻辑）。

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