Rails 6 中belongs_to关联使用foreign_type参数报未知键错误问题排查

foreign_type不是belongs_to的独立合法配置项，它仅作为多态关联的附属参数存在，必须配合polymorphic: true标记使用，作用是指定存储多态类型字段的数据库列名。

旧版本可正常运行的逻辑 #

Rails 5及更早版本对关联定义的参数校验非常宽松，不会严格校验传入的配置键合法性。哪怕传入的参数和当前关联类型不匹配，只要关联后续读取到对应多态标记，就会自动使用传入的foreign_type值；即便没有显式开启多态，这类不匹配的参数也大多会被静默忽略，不会直接抛出运行时错误。

Rails 6触发报错的原因 #

Rails 6对关联定义的参数校验规则做了严格收紧，会直接对所有不属于当前关联类型的配置键抛出ArgumentError。你当前的关联定义没有开启多态标记，等于给普通单态belongs_to传了仅多态关联支持的foreign_type参数，直接触发了校验拦截。

修正方案 #

• 如果当前关联确实需要实现多态映射，必须补上polymorphic: true标记，修正后的代码为：

belongs_to :entity, foreign_key: 'user_id', foreign_type: 'ruby_type', polymorphic: true

• 如果当前关联是普通单态关联，直接删除不需要的foreign_type参数即可，修正后的代码为：

belongs_to :entity, foreign_key: 'user_id'

补充提示：旧版本Rails的宽松校验本质是没有强制规范语法的隐性疏漏，很多沿用多年的老配置本身就存在语法不规范的问题，只是没有被校验拦截暴露，Rails 6的严格校验是将这类历史遗留的不规范写法显性化，并非直接废弃了原有配置语法。

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