SQL Inner Join在Heroku Postgres中返回layout_id为None及列歧义问题求助

核心问题 #

你遇到的两个现象本质是同一个原因：Heroku上的Postgres数据库中，classes表意外包含了layout_id列，导致JOIN查询时出现列名冲突。

验证问题 #

先执行以下SQL查询，确认classes表的结构：

SELECT column_name FROM information_schema.columns WHERE table_name = 'classes';

如果结果中包含layout_id，说明迁移过程中出现了错误（本地SQLite的classes表原本没有该列）。

临时解决方案（立即修复查询） #

不管表结构是否有问题，始终给查询的列加上表名前缀，明确指定要取哪个表的字段，避免歧义：

id = session.get("user_id")
layouts = db.execute("""
    SELECT layouts.layout_id, layouts.class_id, layouts.layout_name, 
           layouts.num_groups, layouts.disp_first, layouts.disp_nick, 
           layouts.disp_last, layouts.disp_grade, layouts.front_loc,
           classes.user_id, classes.classname, classes.period
    FROM layouts 
    INNER JOIN classes ON classes.class_id = layouts.class_id 
    WHERE classes.user_id = ?
""", (id,))

这样就能确保取到layouts表的layout_id，不会被其他表的同名字段覆盖。

彻底修复（修正表结构） #

如果确认classes表不需要layout_id列，执行以下SQL删除该列：

ALTER TABLE classes DROP COLUMN layout_id;

执行后再用之前的查询，就不会出现歧义问题了。

本地与线上差异原因 #

本地SQLite的classes表没有layout_id列，JOIN时不会出现列名冲突，数据库驱动能正确返回layouts.layout_id的值。但Postgres迁移过程中可能因工具bug、误操作等原因，给classes表新增了多余的layout_id列，导致查询时出现字段覆盖或歧义。

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