Django使用TrigramSimilarity搜索时提示similarity函数不存在

这个错误不是因为缺少similarity函数的导入，核心原因是你的PostgreSQL数据库未启用pg_trgm扩展——Django的TrigramSimilarity底层依赖该扩展提供的similarity函数，未启用时就会触发这个报错。

具体解决步骤： #

1. 手动启用pg_trgm扩展
   登录你的PostgreSQL数据库（通过psql命令行、pgAdmin等工具），执行以下SQL命令：

   CREATE EXTENSION IF NOT EXISTS pg_trgm;
   

2. 确认Django导入配置
   确保代码已正确导入TrigramSimilarity：

   from django.contrib.postgres.search import TrigramSimilarity
   

   你的现有代码已经在使用该类，只要导入语句无误即可。

3. 验证数据库引擎适配
   检查项目settings.py的数据库配置，确保使用PostgreSQL引擎（TrigramSimilarity是PostgreSQL专属功能，不支持SQLite、MySQL）：

   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.postgresql',
           'NAME': '你的数据库名',
           'USER': '数据库用户名',
           'PASSWORD': '数据库密码',
           'HOST': 'localhost',
           'PORT': '5432',
       }
   }
   

自动化启用扩展的方案 #

如果需要通过Django迁移自动启用扩展，可以按以下操作：

• 创建空迁移文件：python manage.py makemigrations --empty 你的应用名
• 编辑生成的迁移文件，添加扩展启用操作：

  from django.db import migrations
  from django.contrib.postgres.operations import TrigramExtension
  
  class Migration(migrations.Migration):
      operations = [
          TrigramExtension(),
      ]
  

• 执行迁移：python manage.py migrate

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