Rails Admin中如何让associated_collection_scope生效于show/list操作

associated_collection_scope从设计上仅服务于新建、编辑页面的表单关联组件（下拉选择、多选输入），用来筛选可选的关联集合。show、list页面的关联展示走独立的查询链路，默认不会触发这套作用域逻辑，因此需要针对性调整才能让过滤规则同步生效。

方案1：模型层绑定关联默认作用域（全场景兼容） #

如果希望所有涉及该关联的操作（包括表单选择、show页关联列表、list页关联展示）都套用统一过滤规则，最稳妥的方式是把作用域逻辑下沉到Active Record模型层：

• 在被关联的模型上定义通用作用域，例如给Comment模型定义软删除过滤规则：scope :not_deleted, -> { where(deleted_at: nil) }
• 在主模型定义关联时，直接把作用域挂到关联回调上，例如Post模型的关联配置：has_many :comments, -> { not_deleted }
• 这种配置下，Rails Admin拉取任意和这条关联相关的数据时，都会自动套用过滤规则，不需要在各个页面单独写兼容逻辑。原来在Rails Admin表单配置里写的associated_collection_scope可以直接复用这个模型层的作用域，避免重复编写判断条件。

方案2：页面配置层单独覆盖关联查询逻辑 #

如果不希望改动模型层的全局关联规则（比如需要保留某些场景下查看全量关联数据的能力，仅在show、list页做过滤），可以在Rails Admin的模型配置里，针对独立页面的关联区块单独设置作用域：

• 针对list页的关联字段：在list配置块中，给对应关联字段重写展示逻辑，直接调用带过滤规则的关联查询，替换默认的全量关联结果：

list do
  field :comments do
    formatted_value do
      bindings[:object].comments.not_deleted.limit(5).pluck(:title).join('、')
    end
  end
end

• 针对show页的关联集合：在show配置块中，给对应关联字段单独绑定作用域，这个配置和全局表单用的associated_collection_scope是独立的配置入口，配置后会直接作用于show页的可分页关联列表：

show do
  field :comments do
    associated_collection_scope do
      Proc.new { |scope| scope.not_deleted }
    end
  end
end

常见注意事项 #

• 在全局configure块下配置的associated_collection_scope作用范围有限，从版本迭代至今始终仅覆盖表单编辑场景，不要默认认为它会自动同步到show、list页面的关联展示逻辑。
• 作用域的返回值必须保持ActiveRecord::Relation类型，不要直接返回已经加载完成的数组，否则会导致Rails Admin内置的关联分页、数量统计功能报错。
• 如果采用模型层的全局关联作用域，需要注意副作用：后台管理员需要查看被过滤掉的关联数据时，需要在对应入口手动调用unscoped绕过默认作用域，避免出现数据不可见的问题。

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