如何通过Django ORM为现有SearchVectorField增量添加词位？

PostgreSQL中可以用||操作符增量合并现有tsvector值，示例SQL如下：

UPDATE acme_table 
SET my_tsvector = my_tsvector || 
        to_tsvector('english', 'some new words to add to existing ones') 
WHERE id = 1234;

要通过Django ORM实现类似的增量更新（而非重新构建整个SearchVector），需要绕过现有框架的一些限制，以下是具体分析和可行方案：

现有尝试的问题 #

直接操作实例属性报错 #

SearchVectorField从数据库读取后返回的是字符串类型，而非SearchVector实例，因此执行以下代码时：

from django.contrib.postgres.search import SearchVector

instance.my_tsvector_prop += SearchVector(
    ["new", "fields"], 
    weight="A", 
    config='english'
)

会触发错误：TypeError: SearchVector can only be combined with other SearchVector instances, got str.——字符串无法与SearchVector实例直接相加。

F表达式更新报错 #

尝试用F()表达式关联现有字段和新的SearchVector时：

MyModel.objects
    .filter(pk=1234)
    .update(my_tsvector_prop=
        F("my_tsvector_prop") + 
        SearchVector(
            ["new_field_name"], 
            weight="A", 
            config='english')
        )
    )

会出现FieldError: Cannot resolve expression type, unknown output_field，原因是Django无法自动推断F() + SearchVector组合后的输出字段类型。

可行的ORM解决方案 #

可以通过自定义Func表达式模拟PostgreSQL的||操作符，直接在数据库层面完成tsvector的高效合并：

from django.db.models import Func
from django.contrib.postgres.fields import SearchVectorField
from django.contrib.postgres.search import SearchVector

class TsVectorConcat(Func):
    function = '||'
    output_field = SearchVectorField()

# 执行增量更新
MyModel.objects.filter(pk=1234).update(
    my_tsvector_prop=TsVectorConcat(
        F('my_tsvector_prop'),
        SearchVector(["new_field_name"], weight="A", config='english')
    )
)

这个自定义Func明确指定了输出字段类型为SearchVectorField，解决了F表达式的类型推断问题，同时直接调用数据库原生的合并逻辑，避免了内存层面的低效操作。

补充说明 #

Django目前存在一个未修复的问题：SearchVectorField返回的是字符串而非SearchVector实例，修复后可能支持直接用+操作符合并，但即使修复，这种方式也需要先将数据库中的tsvector值拉取到内存再合并，效率不如直接在数据库端执行的||操作。

如果暂时不想自定义Func，也可以用原生SQL更新，但ORM方案更利于维护多表关联的查询逻辑，符合可持续性需求。

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