Wagtail 4.0.1 后台搜索在PostgreSQL 12.12中无法使用问题咨询

问题诊断 #

从SQLite迁移到PostgreSQL后，Wagtail后台搜索触发ProgrammingError提示ts_rank函数不存在，核心原因是PostgreSQL缺少Wagtail数据库搜索依赖的全文搜索扩展，或迁移后搜索索引未正确重建。

解决方案 #

1. 启用PostgreSQL必要的全文搜索扩展 #

Wagtail的database搜索后端依赖PostgreSQL的pg_trgm和btree_gin扩展，需手动启用：

CREATE EXTENSION IF NOT EXISTS pg_trgm;
CREATE EXTENSION IF NOT EXISTS btree_gin;

可通过PostgreSQL客户端（如psql）执行，或通过Django自定义迁移脚本执行。

2. 确认Wagtail搜索后端配置正确性 #

Wagtail 3+已废弃旧的postgres搜索后端，统一整合到database后端，确保配置正确：

# settings.py
WAGTAILSEARCH_BACKENDS = {
    'default': {
        'BACKEND': 'wagtail.search.backends.database',
        'OPTIONS': {
            'database': 'default',  # 对应DATABASES中的数据库配置项
        }
    }
}

3. 重建Wagtail搜索索引 #

迁移数据库后，原有SQLite环境下的搜索索引无法适配PostgreSQL，需重新生成：

python manage.py update_index

4. 同步Wagtail搜索相关表结构 #

执行Wagtail搜索模块的迁移，确保所有表结构正确同步到PostgreSQL：

python manage.py migrate wagtailsearch

补充说明 #

• 旧的SQLite不支持PostgreSQL的全文搜索函数，迁移后必须启用对应扩展才能让Wagtail的database后端正常调用ts_rank等函数
• pgloader迁移仅处理数据迁移，不会自动启用PostgreSQL扩展或重建Wagtail搜索索引，这是导致问题的主要原因

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