Django State模型region字段模糊搜索无法匹配别名问题求助

问题描述 #

待搜索的示例文本如下：

State 模型数据 #

{
    "region": "National Capital Territory of Delhi",
    "country": "in"
},
{
    "region": "Union Territory of Chandigarh",
    "country": "in"
}

服务端有国家、州/地区两个模型，用户选择居住国家后，会筛选展示对应国家的州/地区列表。
当前使用的查询语句，输入Chandigarh时可以正常匹配到Union Territory of Chandigarh：

state = loginModels.State.objects.filter(country=country_code.lower()).filter(region__icontains=state).get()

但输入NCT of Delhi时查询失败，改用Q方法查询仍然失败：

state = loginModels.State.objects.filter(country=country_code.lower()).filter(Q(region__icontains=query)).get()

补充说明 #

此处的输入来自后端系统，系统会发起类似NCT的缩写查询，这类场景下现有查询逻辑都会失效，且不希望对地点名称做硬编码处理。

可行解决方案 #

方案1：新增别名存储字段，匹配范围覆盖别名 #

在State模型中新增aliases字段存储地区的常用缩写、别名，查询时同时匹配地区全称和别名。如果使用PostgreSQL作为数据库，可直接使用ArrayField存储多别名：

# 模型修改
from django.contrib.postgres.fields import ArrayField
from django.db import models

class State(models.Model):
    region = models.CharField(max_length=100)
    country = models.CharField(max_length=2)
    # 存储地区常用缩写、别名，如德里的aliases可存["NCT", "NCT of Delhi"]
    aliases = ArrayField(models.CharField(max_length=50), default=list, blank=True)

查询逻辑调整：

from django.db.models import Q

query = "NCT of Delhi"
# 用first()替代get()，避免匹配不到或多结果抛出异常
state = loginModels.State.objects.filter(
    country=country_code.lower()
).filter(
    Q(region__icontains=query) | Q(aliases__icontains=query)
).first()

如果不使用PostgreSQL，可改用TextField存储逗号分隔的别名，查询逻辑不变。

方案2：基于trigram相似度匹配，无需手动维护别名 #

如果不想手动维护别名列表，可使用PostgreSQL的pg_trgm扩展实现模糊相似度匹配，对缩写、拼写错误的场景适配性更好。
首先开启数据库pg_trgm扩展，给region字段添加GIN索引提升查询效率，之后查询时按相似度排序取最高结果即可：

from django.contrib.postgres.search import TrigramSimilarity

query = "NCT"
state = loginModels.State.objects.filter(
    country=country_code.lower()
).annotate(
    # 计算查询词和region字段的相似度
    similarity=TrigramSimilarity('region', query)
).filter(
    # 相似度阈值可根据业务场景调整，0-1之间越高匹配越严格
    similarity__gt=0.3
).order_by('-similarity').first()

方案3：新增首字母缩写字段适配缩写查询 #

如果系统查询的输入多为全称首字母缩写，可在State模型中新增region_abbr字段，存储地区全称的首字母缩写，写入数据时自动同步生成，查询时同时匹配全称和缩写字段即可。

注意事项 #

• 所有查询场景优先用first()替代get()，提前做好查询结果为空的降级处理
• 查询前可对输入词做标准化处理，比如统一大小写、去除特殊字符，提升匹配准确率

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