Django中使用TrigramSimilarity搜索报错：no such function: SIMILARITY

这个问题我之前踩过坑！其实核心原因是你的PostgreSQL数据库还没安装pg_trgm扩展——Django的TrigramSimilarity完全依赖这个PostgreSQL官方扩展来提供相似度计算的底层支持，官方文档里可能没把这个前置条件写得特别突出。

下面是两种可靠的解决方法：

方法一：手动在数据库中创建扩展 #

这是最快的临时解决方式，适合本地调试：

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

  psql -d your_database_name -U your_username
  

• 在PostgreSQL命令行中执行创建扩展的语句：

  CREATE EXTENSION IF NOT EXISTS pg_trgm;
  

• 输入\q退出命令行，重启你的Django开发服务器，再运行查询代码就应该正常了。

方法二：用Django迁移自动创建扩展（推荐团队协作场景） #

这种方法能把扩展安装步骤纳入项目的迁移流程，避免其他开发者重复踩坑：

1. 为你的app生成一个空的迁移文件：

   python manage.py makemigrations --empty your_app_name
   

   把your_app_name替换成你实际的应用名称（比如articles）。
2. 打开生成的迁移文件，修改内容如下：

   from django.db import migrations
   from django.contrib.postgres.operations import CreateExtension
   
   class Migration(migrations.Migration):
       dependencies = [
           ('your_app_name', '0001_initial'),  # 替换成你app当前最新的迁移文件名
       ]
   
       operations = [
           CreateExtension('pg_trgm'),
       ]
   

3. 执行迁移命令完成扩展安装：

   python manage.py migrate
   

额外验证点 #

别忘了确认你的项目确实使用的是PostgreSQL数据库——TrigramSimilarity是Django专为PostgreSQL设计的功能，如果你用SQLite、MySQL等其他数据库，这个功能本身就无法工作。

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