Rails 5.1.5+PG10.0.0启用UUID扩展仍报gen_random_uuid()不存在错误

嘿，我之前在Rails新项目里也碰到过一模一样的情况！明明已经启用了UUID相关扩展，结果还是弹出PG::UndefinedFunction: ERROR: function gen_random_uuid() does not exist的报错，折腾了好一阵才找到根源，给你几个靠谱的排查和修复步骤：

1. 先确认pgcrypto扩展真的装到了当前数据库里 #

gen_random_uuid()这个函数是PostgreSQL的pgcrypto扩展提供的，不是默认自带的。很多时候我们以为开了扩展，其实只是在配置里写了，没真正在目标数据库生效：

• 打开终端，连接到你的项目数据库：

  psql your_project_development
  

• 执行这条SQL检查已安装的扩展：

  SELECT * FROM pg_extension WHERE extname = 'pgcrypto';
  

如果没返回任何结果，说明扩展没装，赶紧执行安装命令：

CREATE EXTENSION IF NOT EXISTS pgcrypto;

（注意要用有数据库权限的用户执行，比如postgres超级用户）

2. 让Rails自动帮你管理扩展，避免手动操作遗漏 #

手动装扩展容易在新环境或部署时翻车，最好用Rails迁移来自动处理：

• 生成一个专门的迁移文件：

  rails generate migration AddPgcryptoExtension
  

• 打开这个迁移文件，替换成下面的内容：

  class AddPgcryptoExtension < ActiveRecord::Migration[你的Rails版本号]
    def change
      enable_extension 'pgcrypto' unless extension_enabled?('pgcrypto')
    end
  end
  

• 最后运行迁移：

  rails db:migrate
  

这样以后不管是本地新环境还是部署到服务器，都会自动检查并启用pgcrypto扩展。

3. 检查数据库连接用户的权限 #

有时候扩展装了，但Rails连接数据库用的用户没有访问pgcrypto的权限，也会报错。可以给用户赋权：

GRANT USAGE ON SCHEMA pgcrypto TO your_database_username;

4. 确认PostgreSQL版本够不够 #

gen_random_uuid()是从PostgreSQL 9.4版本开始才在pgcrypto扩展里支持的，如果你的新项目用了更老的PG版本，肯定会出问题。赶紧检查下版本：

psql --version

如果版本低于9.4，要么升级PostgreSQL，要么换个UUID生成方式——比如用Rails自带的SecureRandom.uuid，在模型的before_create回调里手动赋值主键。

5. 对比旧项目的配置差异 #

你之前Rails4.2能用，大概率是旧项目的数据库已经提前装了pgcrypto，或者当时用的是另一个UUID扩展uuid-ossp。如果上面的方法都不行，可以试试切换到uuid-ossp：

• 先安装扩展：

  CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
  

• 在Rails配置里指定主键类型：
  打开config/application.rb，添加这段配置：

  config.generators do |g|
    g.orm :active_record, primary_key_type: :uuid
  end
  

• 新建表的时候指定默认值：

  create_table :your_table_name, id: :uuid do |t|
    # 你的字段定义
    t.timestamps
  end
  

  如果是修改现有表，就用：

  change_column :your_table_name, :id, :uuid, default: "uuid_generate_v4()"
  

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