为什么我的Postgres复合主键无法接受预期的插入数据？

问题根因 #

你最初误以为是复合主键重复触发的报错，实际从补充的报错信息可以定位，错误和主键设置无关，是country_code字段的外键约束校验失败。

具体原因 #

• 你创建表时给country_code字段加了指向public.lang_country_codes表的外键约束，要求插入的country_code值必须在该关联表中存在对应记录。
• 第一条插入的BR国家代码在lang_country_codes表中存在，所以可以插入成功；第二条插入的US国家代码不存在于该表中，因此触发外键约束报错。
• 你移除country_code的外键引用后问题消失，也完全验证了这一结论。

解决方法 #

1. 先查询lang_country_codes表的存量数据，确认需要用到的国家代码是否都已入库，将缺失的国家代码（比如US）补充进该表后，即可正常插入数据。
2. 若你的业务场景允许存在无国家维度的通用翻译（比如通用英文不需要区分美英/英英），可以将country_code字段设置为可空，复合主键规则无需调整，Postgres会将多个NULL值视为互不相同，不会触发唯一性冲突。

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