Rails 5生产部署报错：ActiveSupport::Concern多included块定义问题

你遇到的Cannot define multiple 'included' blocks for a Concern错误，核心原因是某个使用ActiveSupport::Concern的模块被重复定义了included代码块。而开发环境正常、生产环境报错的情况，大概率和依赖版本不一致或生产环境gem加载逻辑异常有关，结合你使用Solidus+Rails 5的场景，给你以下排查和修复步骤：

一、先定位问题根源 #

你当前的报错堆栈只到activesupport的核心文件，需要先找到具体是哪个模块触发了问题：

• 查看生产环境的完整错误日志（比如部署日志、log/production.log），里面会显示引发错误的具体gem或自定义模块路径。
• 也可以在生产环境启动rails console production，尝试加载相关业务模块，看是否能触发错误并定位到具体文件。

二、确保Gem依赖完全一致 #

开发和生产环境gem版本不一致是这类问题的高发原因：

• 把开发环境的Gemfile.lock复制到生产环境，执行bundle install --deployment，强制生产环境安装和开发环境完全相同的gem版本。
• 用bundle show solidus、bundle show solidus_core命令，确认开发和生产环境的Solidus核心组件版本是否一致，误装不兼容版本很容易触发此类冲突。

三、检查自定义Concern代码 #

如果是你自己编写的模块使用了ActiveSupport::Concern，务必确保每个模块只有一个included代码块：

错误示例（重复定义included） #

module CustomOrderConcern
  extend ActiveSupport::Concern
  
  included do
    has_many :line_items
  end
  
  included do
    validates :total, presence: true
  end
end

正确写法（合并到一个included块） #

module CustomOrderConcern
  extend ActiveSupport::Concern
  
  included do
    has_many :line_items
    validates :total, presence: true
  end
end

四、Solidus相关的特殊排查 #

如果不是自定义代码的问题，那大概率是Solidus或其依赖的gem冲突：

• 尝试升级Solidus到和Rails 5.1.6兼容的最新小版本（比如Solidus 2.7.x系列，官方标注支持Rails 5.1），旧版本可能存在Concern定义的bug。
• 临时移除非必要的Solidus扩展gem，看错误是否消失，逐步排查是否有第三方扩展重复定义了核心Concern。

五、环境配置验证 #

• 确认生产环境的chruby是否正确加载了指定的Ruby版本（2.3.1或2.5.1），执行ruby -v和which ruby验证，避免Ruby版本不一致导致gem加载异常。
• 清理生产环境的gem缓存：执行bundle clean --force，然后重新bundle install，避免残留的旧gem文件干扰加载逻辑。

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