Django测试运行TrigramSimilarity查询报错但实际应用正常如何解决

造成该问题的核心原因有两个：

• 测试数据库未启用pg_trgm扩展：你日常使用的开发库大概率手动执行过CREATE EXTENSION IF NOT EXISTS pg_trgm;开启了三元组相似度扩展，但Django运行单测时会自动创建全新的临时数据库，默认不会自动安装该扩展，首先就会存在函数缺失的问题。
• 测试环境的PostgreSQL类型推断规则更严格：你直接传入Python字符串作为TrigramSimilarity的第二个参数时，Django生成的SQL没有做显式的TEXT类型转换，测试库会将该参数识别为UNKNOWN类型，无法匹配SIMILARITY函数要求的入参类型；而开发库可能因为历史查询缓存、宽松的类型推断规则自动做了隐式转换，所以运行正常。

1. 配置自动安装pg_trgm扩展，避免测试库缺失函数
   在你的任意一个业务app的migrations目录下新建迁移文件（比如命名为0002_add_pg_trgm_extension.py），内容如下：

from django.contrib.postgres.operations import TrigramExtension
from django.db import migrations

class Migration(migrations.Migration):
    dependencies = [
        # 替换为当前app的上一个迁移文件标识，例如('post', '0001_initial')
    ]

    operations = [
        TrigramExtension(),
    ]

后续Django不管是迁移开发库，还是新建单测临时库，都会自动安装pg_trgm扩展。

2. 显式指定查询参数的类型为TEXT
   修改查询逻辑中TrigramSimilarity的传参方式，用Value包裹查询词并指定输出字段为TextField，强制Django生成SQL时做显式类型转换：

from django.db.models import Value
from django.db.models.fields import TextField

# 把原来的TrigramSimilarity('post_title', query)替换为下面的写法
TrigramSimilarity('post_title', Value(query, output_field=TextField()))

3. 可选兼容方案
   如果调整后仍有报错，可以检查测试环境和开发环境的PostgreSQL版本是否一致，不同版本的类型推断规则存在差异，尽量保持环境版本统一即可。

内容的提问来源于stack exchange，提问作者André Carvalho