Supabase本地环境初始化报错：schema 'vault'不存在（SQLSTATE 3F000）求助

问题分析 #

托管版Supabase默认内置vault schema（用于加密功能），但本地环境初始化时未自动创建该schema，或远程迁移文件_remote_commit.sql中遗漏了对应的创建语句，导致启动时触发SQL报错。

修复步骤 #

• 补充Schema创建语句
  打开supabase/migrations/_remote_commit.sql，在文件最顶部添加：

  CREATE SCHEMA IF NOT EXISTS vault;
  

• 重置本地环境
  先停止当前运行的Supabase服务：

  supabase stop
  

  彻底清理本地数据库状态：

  supabase db reset
  

• 重新启动服务
  执行启动命令，让迁移文件重新执行：

  supabase start
  

• 验证修复结果
  启动成功后，访问本地Supabase控制台（默认地址http://localhost:54323），执行以下SQL确认：

  SELECT schema_name FROM information_schema.schemata WHERE schema_name = 'vault';
  

  若返回结果，说明vault schema已成功创建。

额外提示 #

• 若_remote_commit.sql是通过supabase db pull生成，可能因版本兼容问题遗漏schema创建语句，手动补充是最直接的解决方式。
• 确保本地Supabase CLI版本与托管环境版本一致，可通过supabase --version查看，版本不匹配时执行npm update -g supabase更新CLI。

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