YugabyteDB与PostgreSQL函数搜索路径行为差异导致Rails架构导入失败

这个问题的核心是YugabyteDB YSQL和PostgreSQL在空搜索路径下的行为差异：

• 在PostgreSQL 14.1中，当你把搜索路径设为空时，它会隐式包含当前用户的默认schema（通常是public），所以即使路径为空，依然能找到public下的gen_random_uuid()函数。
• 但YSQL（版本11.2-YB-2.13.0.0-b0）在搜索路径为空时，只会搜索pg_catalog schema，而你把pgcrypto扩展安装在了public下，自然找不到对应的函数。

针对这个问题，有几个可行的解决方案：

方案1：修改转储文件中的函数调用，指定schema前缀 #

直接在所有调用gen_random_uuid()的地方加上public.前缀，确保YSQL能定位到函数所在的schema。比如你提到的创建表语句可以改成：

CREATE TABLE public.data (id uuid DEFAULT public.gen_random_uuid() NOT NULL);

方案2：调整搜索路径设置，避免清空 #

你可以修改转储文件中的搜索路径配置，或者在导入前先设置正确的搜索路径：

• 导入前临时设置：在ysqlsh中执行导入命令前，先运行：

  SET search_path = public, pg_catalog;
  

• 修改转储文件：找到转储文件中这一行：

  SELECT pg_catalog.set_config('search_path', '', false);
  

  替换为：

  SELECT pg_catalog.set_config('search_path', 'public, pg_catalog', false);
  

方案3：调整Rails生成structure.sql的配置 #

因为问题根源是Rails生成的转储文件会清空搜索路径，你可以修改Rails配置，避免这种行为：
在config/application.rb中添加或修改以下配置：

# 确保schema导出时包含必要的搜索路径设置
config.active_record.dump_schemas = :all
# 或者直接指定默认schema
config.active_record.default_schema = "public"

这样生成的structure.sql就不会把搜索路径设为空，导入YSQL时就能正常找到gen_random_uuid()函数了。

验证方案 #

你可以在ysqlsh中快速验证：

-- 创建扩展
CREATE EXTENSION IF NOT EXISTS pgcrypto WITH SCHEMA public;
-- 设置空搜索路径
SELECT pg_catalog.set_config('search_path', '', false);
-- 指定schema调用函数，正常返回UUID
SELECT public.gen_random_uuid();

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