Rails ActiveRecord中includes搭配references的查询运行机制疑问

要搞清楚这个问题，得先从includes的底层加载逻辑讲起：
Rails的includes设计的初衷是解决N+1查询问题，它默认支持两种预加载策略：

• 拆分查询：当查询条件、排序逻辑没有用到关联表的字段时，Rails会分两次查询，第一次查主表数据，第二次用主表的外键批量查关联表数据，最后在内存中把数据拼接起来，这种方式查询更轻量，没有冗余数据。
• 左连接合并查询：当你需要用关联表的字段做过滤、排序时，拆分查询无法满足需求，Rails会把所有用到的关联表用LEFT JOIN拼到主表的查询语句中，一次性查出所有需要的数据。

references的核心作用就是告诉Rails当前查询是否需要在SQL语句中引用关联表，触发左连接合并查询的策略，你观察到的「传任意参数都能正常运行」的现象，本质是由以下两个机制共同导致的：

1. 你在where中用了裸SQL字符串"organizations.name like ?"，Rails不会解析裸SQL中的表名，无法自动识别你用到了关联表的字段，这时候你只要调用了references方法且传入了非空参数，不管参数内容是什么，Rails都会判定你需要引用关联表，直接把includes中声明的所有关联全部用LEFT JOIN拼到查询语句中，所以organizations表会被正常关联，你的查询条件不会报找不到表的错误。
2. 你贴出的源码已经说明了，references方法不会校验传入的参数是否是真实存在的表名/关联名，它只是把传入的参数简单存到references_values数组中，Rails判断是否要触发左连接的逻辑只看references_values是不是空数组，不校验里面的内容是否合法，所以你传project: :organization、:projects甚至瞎写的xxxxxx效果是完全一样的，只要数组非空，就会触发左连接。

这并不代表references的参数没有意义，在规范使用的场景下它的作用很明确：

• 如果你用哈希形式写查询条件，比如where(organizations: {name: "blablabla"})，Rails可以自动识别你用到了organizations关联，不需要手动调用references，会自动触发左连接。
• 当你必须用裸SQL写关联表的条件时，传入正确的关联名/表名作为references的参数，Rails可以只关联你实际用到的表，避免includes中声明的多余关联被不必要的LEFT JOIN拖慢查询性能，同时也能让代码可读性更好，其他开发者可以直接看出这个查询引用了哪些关联表。

最佳实践建议 #

1. 关联表查询优先用哈希语法写条件，避免手动写references，减少出错概率
2. 必须用裸SQL的场景，references传实际用到的关联对应的表名，不要传无关值，避免后续Rails版本增加参数校验逻辑后代码失效

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