动态生成PostgreSQL查询时报pq: deleted_at列引用歧义错误

这是PostgreSQL驱动抛出的典型歧义字段错误，触发逻辑非常明确：

• 当前SQL关联了issues（别名i）和vehicles（别名v）两张业务表
• 两张表的通用结构设计中，都存在同名的deleted_at软删除标记字段
• WHERE子句中直接使用了无表前缀的裸字段deleted_at，数据库无法判断该字段需要取哪张表的数据，因此中断查询抛出歧义错误

所有方案的核心原则是：消除字段的所属表歧义，给所有可能重名的字段加上明确的表别名前缀

• 第一步：定位直接触发报错的代码位置，即原SQL中deleted_at IS NULL这一段
• 第二步：根据实际业务的过滤规则，给该字段绑定对应的表别名：
  • 如果业务仅需过滤issues表的未删除数据，将写法调整为i.deleted_at IS NULL
  • 如果业务需要过滤关联vehicles表的未删除数据，将写法调整为v.deleted_at IS NULL
• 长期编码规范建议：编写多表关联SQL时，所有出现在SELECT、WHERE、JOIN条件、GROUP BY、ORDER BY中的业务字段，全部强制带上所属表的别名前缀。哪怕当前两张表没有同名字段，后续业务迭代新增同名字段时，也不会突然触发同类歧义报错

如果业务逻辑要求同时过滤两表的未删除数据（避免统计已被软删的issue、或已被软删的车辆关联数据），修正后的完整SQL如下：

SELECT COUNT(*)
FROM issues i
JOIN vehicles v ON (v.id = i.vehicle_id)
WHERE i.asset_owner_id = :asset_owner_id 
  AND i.deleted_at IS NULL
  AND v.deleted_at IS NULL
  AND i.added_at >= :from 
  AND i.added_at < :to 
  AND i.status IN (:status)

常见踩坑提醒：不要只给当前报错的单表deleted_at加前缀后就停止校验，否则很容易出现统计结果包含已被软删的车辆关联数据的逻辑偏差，这类问题不会触发SQL报错，只会在业务对账时暴露问题。

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