PostgreSQL创建GIN索引报function does not exist错误解决方法

报错根因说明 #

两个方案的报错和「存在不支持的语言值就不能建GIN索引」没有关系，分别对应两个明确的问题：

1. 方案一核心错误是函数入参类型不匹配：to_tsvector不存在(regconfig, tsvector)这个重载版本。这个函数的作用是把普通文本（text/varchar类型）转为tsvector类型，第二个参数必须传入原始文本，你传入已经是tsvector类型的content_vector，当然找不到匹配的函数。
2. 方案二有两个问题：一是类型名拼写错误，正确类型名是regconfig不是你写的reconfig；二是直接强转字段类型前没有清洗存量数据，库里存在afrikaans这类当前版本PostgreSQL没有内置对应分词配置的语言值，强转时自然会抛出配置不存在的错误。

可落地的解决方案 #

就算存在PostgreSQL不支持的语言值，也完全可以正常创建GIN索引，根据你的表结构选对应方案即可：

方案1：不修改现有表结构直接建索引（推荐） #

如果你的content_vector字段是已经提前按对应语言规则生成好的tsvector值，根本不需要在创建索引时嵌套调用to_tsvector，直接对tsvector字段建GIN索引即可：

CREATE INDEX pages_vector_ix ON pages USING GIN (content_vector);

如果你之前建表时字段名取错了，content_vector实际存的是原始文本内容（只是类型设成了tsvector，这种设计本身不合理），建索引时加一层兜底逻辑，遇到不支持的语言值自动 fallback 到simple分词规则（按空格切分，无词干提取，兼容所有语言的基础检索）：

CREATE INDEX pages_vector_ix ON pages USING GIN (
  to_tsvector(
    CASE 
      WHEN lang IN (SELECT cfgname FROM pg_catalog.pg_ts_config) THEN lang::regconfig
      ELSE 'simple'::regconfig
    END,
    content_vector::text -- 把tsvector强转为文本传入，符合to_tsvector的入参要求
  )
);

方案2：修改lang字段类型为regconfig后建索引 #

如果你希望把lang字段存为regconfig类型减少运行时转换开销，先清洗存量数据再改字段类型即可：

1. 先把所有不被支持的语言值统一替换为兜底的simple配置

UPDATE pages 
SET lang = 'simple' 
WHERE lang NOT IN (SELECT cfgname FROM pg_catalog.pg_ts_config);

2. 修正拼写错误后修改字段类型

ALTER TABLE pages ALTER COLUMN lang TYPE regconfig USING lang::regconfig;

3. 后续建索引时，如果是对原始文本生成tsvector，直接传入lang字段即可不需要额外做类型转换；如果content_vector已经是预生成的tsvector，直接参考方案1的第一句SQL建索引就行。

注意事项 #

如果后续业务会持续插入新的语言值，建议在写入逻辑里提前做校验：遇到pg_ts_config不存在的语言值，统一替换为simple再写入，避免触发类型转换错误。

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