使用pg_search trigram功能触发PG::UndefinedFunction错误求助

看起来你的问题核心是PostgreSQL找不到trigram匹配所需的%运算符，虽然你在schema文件里声明了启用pg_trgm扩展，但可能实际没在数据库中生效，或者pg_search的配置需要调整。下面是一步步的解决思路：

1. 确认pg_trgm扩展确实已启用 #

有时候schema文件里的配置不会自动同步到运行中的数据库，你可以手动执行语句确保扩展生效：

在Rails控制台中运行：

ActiveRecord::Base.connection.execute("CREATE EXTENSION IF NOT EXISTS pg_trgm;")

或者直接通过psql连接你的数据库，执行：

CREATE EXTENSION IF NOT EXISTS pg_trgm;

执行完后，你可以用\dx命令在psql里查看已安装的扩展，确认pg_trgm在列表中。

2. 调整pg_search_scope的配置 #

你的当前配置生成的SQL混合了全文搜索（ts_rank、to_tsvector）和trigram的%运算符，这可能导致类型匹配问题。如果只想用trigram进行相似性匹配，建议明确配置trigram的参数：

修改你的Card模型代码：

class Card < ApplicationRecord
  include PgSearch
  pg_search_scope :spelled_like,
                  against: :name,
                  using: {
                    trigram: {
                      threshold: 0.2, # 阈值越低，匹配越宽松，可根据需求调整
                      word_similarity: true # 使用单词级别的相似性匹配
                    }
                  }
end

这样配置后，pg_search会生成更纯粹的trigram查询，避免不必要的全文搜索逻辑干扰。

3. 手动测试trigram运算符是否正常 #

在psql中直接执行以下查询，验证trigram功能是否工作：

SELECT name, similarity(name, 'Timeslream Navigator') 
FROM cards 
WHERE name % 'Timeslream Navigator';

如果这个查询能返回你预期的TimesTReam Navigator记录，说明扩展已经生效，问题出在pg_search的配置上；如果仍然报错，那说明扩展还没正确安装，需要重新检查数据库的扩展配置。

关于你执行SQL时的语法错误 #

你在irb中直接粘贴SQL时出现语法错误，是因为没有把整个SQL语句包裹成字符串。可以用 heredoc 格式来执行：

sql = <<-SQL
SELECT "cards".* FROM "cards" INNER JOIN (SELECT "cards"."id" AS pg_search_id, (ts_rank((to_tsvector('simple', coalesce("cards"."name"::text, ''))), (to_tsquery('simple', ''' ' || 'Timeslream' || ' ''') && to_tsquery('simple', ''' ' || 'Navigator' || ' ''')), 0)) AS rank FROM "cards" WHERE (((coalesce("cards"."name"::text, '')) % 'Timeslream Navigator'))) AS pg_search_6ac9a32c0ca8e84e5bf0c3 ON "cards"."id" = pg_search_6ac9a32c0ca8e84e5bf0c3.pg_search_id ORDER BY pg_search_6ac9a32c0ca8e84e5bf0c3.rank DESC, "cards"."id" ASC LIMIT 11
SQL
ActiveRecord::Base.connection.execute(sql)

不过这只是临时测试，核心还是要解决扩展和pg_search配置的问题。

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