Rails 5.1关联查询疑问：where(association: @association)为何需改用_id后缀？

你遇到的这个问题确实和Rails 5.x的内部行为变更有关，虽然官方文档没有专门高亮这个细节，但关联查询的参数处理逻辑在Rails 5.0中有细微调整，尤其是在关联推断和外键映射的环节。

可能的原因 #

1. 关联反向推断的严格性提升
   Rails 4.2中，Active Record会自动推断has_many和belongs_to之间的反向关联，即使你没有显式设置inverse_of。但在Rails 5.0+中，自动推断的逻辑变得更严格，如果关联名称和模型名称的命名不符合默认规则（比如单数/复数匹配），可能无法正确识别关联对应的外键字段，导致where(transaction_record: @tr)无法转换成transaction_record_id = ?的查询条件，反而生成了无效的SQL（比如尝试匹配不存在的transaction_record字段，而非外键），最终导致无结果返回且无报错（部分数据库对不存在的字段查询会返回空结果而非报错）。

2. 未持久化对象的处理变化
   虽然你提到4.2中可以正常查询，但如果@transaction_record是未持久化的对象（即还没保存到数据库，id为nil），Rails 4.2可能会忽略这个条件返回所有结果，而Rails 5.x会严格生成transaction_record_id IS NULL的条件，导致无结果。不过根据你改成transaction_record_id: @tr.id能正常查询的情况，这个可能性较低，但可以排查一下@transaction_record.persisted?是否为true。

解决方案 #

方案1：显式设置反向关联（推荐） #

在模型中显式添加inverse_of，帮助Active Record明确关联关系，确保查询时能正确映射外键：

class TransactionRecord < ApplicationRecord
  has_many :documents, inverse_of: :transaction_record
end

class Document < ApplicationRecord
  belongs_to :transaction_record, inverse_of: :documents
end

添加后，Document.where(transaction_record: @transaction_record)应该就能像Rails 4.2中一样正常工作了。

方案2：使用关联对象的查询方法 #

除了直接修改where条件，你也可以通过关联对象本身来查询，这种方式在Rails各版本中都稳定：

# 通过TransactionRecord的关联直接获取文档
@transaction_record.documents

# 若需要添加额外查询条件
@transaction_record.documents.where(status: 'completed')

方案3：保持外键字段的写法（你当前的解决方式） #

你已经发现的Document.where(transaction_record_id: @transaction_record.id)是最直接且兼容性最好的写法，在所有Rails版本中都能稳定运行，如果你不需要依赖关联名称的语法，这种方式完全可以继续使用。

官方文档的相关说明 #

虽然没有专门针对这个问题的单独章节，但在Rails 5.0的Release Notes中，关于Active Record的部分提到了关联反向推断的优化，以及belongs_to默认必填的变更（虽然这和查询行为不直接相关，但关联处理的整体逻辑变得更严谨）。另外，在Active Record查询指南中，关于查询关联对象的部分也提到了使用where(association: object)的前提是关联关系被正确识别，显式设置inverse_of可以避免推断错误。

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