Rails迁移报DEFAULT表达式无法使用列引用（PG::FeatureNotSupported）

• 报错的核心逻辑：PostgreSQL最终执行的SQL是给total列设置了DEFAULT默认值表达式，而非定义存储生成列。PostgreSQL本身就不允许在DEFAULT默认值中引用其他列的取值，因此直接抛出cannot use column reference in DEFAULT expression错误。
• 你写的GENERATED ALWAYS AS (...) STORED生成列语法没有生效，最终被解析成DEFAULT子句，通常是以下三种原因导致：
  1. PostgreSQL版本低于12。STORED类型的存储生成列是PostgreSQL 12才正式上线的特性，11及更早版本无法识别这段生成列语法，解析SQL时会把括号内的计算表达式误判为DEFAULT子句的内容，最终触发默认值相关报错。
  2. 之前写迁移时混淆了生成列和默认值的写法，误用add_column :total, :decimal, default: -> { "COALESCE(price, 0) * COALESCE(quantity, 0)" }逻辑，且没有清理残留的迁移任务或脏的数据库结构，Rails会按照默认值逻辑生成SQL，而非生成列逻辑。
  3. 写原生SQL时存在格式问题或被Rails自动转义，导致生成列语法没有被正确拼接到最终执行的SQL中。

首先先连接数据库执行SELECT version();确认PostgreSQL版本，再选择对应方案： #

方案1：PostgreSQL 12+ 版本用Rails原生语法（推荐） #

Rails 6.1已经原生支持PostgreSQL存储生成列，不需要手写原生SQL，框架会自动处理回滚逻辑，迁移代码如下：

class AddTotalToOrderLines < ActiveRecord::Migration[6.1]
  def change
    add_column :order_lines, :total, :numeric,
      as: "COALESCE(price, 0) * COALESCE(quantity, 0)",
      stored: true
  end
end

注意两个必填参数：

• as：传入生成列的计算表达式
• stored: true：明确指定为STORED存储生成列。PostgreSQL目前不支持VIRTUAL虚拟生成列，不传这个参数会报错。

方案2：PostgreSQL 12+ 版本用原生SQL写法 #

如果习惯手写SQL，需要补全回滚逻辑，避免迁移回滚时报错：

class AddTotalToOrderLines < ActiveRecord::Migration[6.1]
  def up
    execute <<~SQL
      ALTER TABLE order_lines
      ADD COLUMN total numeric GENERATED ALWAYS AS (COALESCE(price, 0) * COALESCE(quantity, 0)) STORED;
    SQL
  end

  def down
    remove_column :order_lines, :total
  end
end

执行前可以先把SQL片段复制到PostgreSQL客户端直接运行，验证语法没有问题再跑迁移。 #

方案3：PostgreSQL 11及更早版本兼容方案 #

低版本PostgreSQL不支持生成列特性，需要通过触发器实现字段自动计算：

class AddTotalToOrderLines < ActiveRecord::Migration[6.1]
  def up
    # 先加普通数值列
    add_column :order_lines, :total, :numeric
    # 定义触发器函数和绑定触发器
    execute <<~SQL
      CREATE OR REPLACE FUNCTION calculate_order_line_total()
      RETURNS TRIGGER AS $$
      BEGIN
        NEW.total = COALESCE(NEW.price, 0) * COALESCE(NEW.quantity, 0);
        RETURN NEW;
      END;
      $$ LANGUAGE plpgsql;

      CREATE TRIGGER trg_calculate_order_line_total
      BEFORE INSERT OR UPDATE ON order_lines
      FOR EACH ROW EXECUTE FUNCTION calculate_order_line_total();

      # 初始化历史数据的total字段值
      UPDATE order_lines SET total = COALESCE(price, 0) * COALESCE(quantity, 0);
    SQL
  end

  def down
    # 回滚时先删触发器再删列
    execute <<~SQL
      DROP TRIGGER IF EXISTS trg_calculate_order_line_total ON order_lines;
      DROP FUNCTION IF EXISTS calculate_order_line_total();
    SQL
    remove_column :order_lines, :total
  end
end

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