使用Supabase CLI推送至远程DB时Gender枚举已存在错误的修复方案

问题根源 #

本地数据库的变更检测生成了重复创建远程已存在的Gender枚举类型的SQL语句，导致推送时触发42710错误。

解决方案 #

1. 核对本地与远程的Enum定义 #

先确认本地和远程的Gender枚举是否一致：

• 本地通过Supabase CLI进入psql：supabase db psql，执行命令：

  \d+ "Gender"
  

• 远程在Supabase Dashboard的SQL编辑器中执行同样命令，对比枚举值列表。

2. 手动修正迁移文件 #

根据核对结果修改生成的迁移文件（lang_and_sport_support.sql）：

• 如果本地只是新增了枚举值：删除原有的CREATE TYPE语句，替换为ALTER TYPE添加新值：

  -- 假设新增了'not_specified'值
  ALTER TYPE "public"."Gender" ADD VALUE IF NOT EXISTS 'not_specified';
  -- 其他新增值同理添加
  

• 如果本地重复创建了已有Enum：直接删除迁移文件中的CREATE TYPE "public"."Gender" ...整行，保留其他变更语句。
• 需要兼容Enum不存在的场景：用PL/pgSQL的条件判断包裹创建语句，避免重复创建：

  DO $$
  BEGIN
    IF NOT EXISTS (SELECT 1 FROM pg_type WHERE typname = 'Gender' AND typnamespace = 'public'::regnamespace) THEN
      CREATE TYPE "public"."Gender" AS enum ('male', 'female', 'other', 'not_specified');
    END IF;
  END $$;
  

3. 测试并推送迁移 #

• 本地先执行supabase db reset，验证迁移文件能正常运行，无报错。
• 确认没问题后执行supabase db push，将变更推送到远程数据库。

后续建议 #

• 尽量通过编写迁移文件修改数据库schema，而非直接在本地GUI操作，避免本地与远程schema不一致。
• 每次本地开发前执行supabase db pull，拉取远程最新schema到本地，减少冲突概率。

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