Ruby on Rails中has_one关联下使用.where查询是否需用复数模型名？

针对你的问题，先给出明确结论：两种写法都能正常运行，但符合Rails规范的正确写法是使用复数表名roles，单数role能生效是因为Rails做了隐式兼容处理。

原因说明 #

• Active Record的where条件本质是映射到数据库表，而Rails默认的数据库表名是复数形式（你的关联对应的表是roles）。
• 当你传入单数role作为键时，Rails内部会自动将其转换为对应的复数表名，所以两种写法最终生成的SQL完全一致。
• 从官方规范和最佳实践来看，直接使用复数表名更直观，也更贴合ORM的设计逻辑，避免依赖隐式转换带来的潜在混淆。

代码示例验证 #

你的两个查询示例：

# 写法1
role = Role.first
User.joins(:role).where(role: role)

# 写法2
role = Role.first
User.joins(:role).where(roles: role)

最终都会生成相同的SQL语句：

SELECT "users".* FROM "users" INNER JOIN "roles" ON "roles"."user_id" = "users"."id" WHERE "roles"."id" = ?

关于版本修订 #

这种单数参数的兼容语法糖在Rails早期版本就已存在，7.0.4及后续版本并没有针对此逻辑的修改PR，因为它属于提升开发体验的设计，只要不产生歧义就会被保留。

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