必须先刷新物化视图并显式定义列（禁用SELECT *），再为其tsvector字段或匹配表达式创建GIN索引；GIN索引不能替代唯一索引支持CONCURRENTLY刷新，且表达式须与查询条件字节级一致才能命中。
物化视图上直接建GIN索引会报错 ERROR: materialized view "xxx" has no columns
PostgreSQL 12+ 允许在物化视图上创建索引，但前提是物化视图必须已刷新（REFRESH MATERIALIZED VIEW），且其定义中明确 SELECT 出了具体列。如果物化视图定义是空的、或用了 SELECT * 且底层表结构后来变了，查询系统目录时可能无法解析出列信息，导致建索引时提示“no columns”。
实操建议：
• 刷新物化视图：REFRESH MATERIALIZED VIEW CONCURRENTLY my_mv;（注意：CONCURRENTLY 要求有唯一索引）
• 检查列是否存在：\d+ my_mv 或 SELECT column_name FROM information_schema.columns WHERE table_name = 'my_mv';
• 避免 SELECT *，显式写出字段，比如 SELECT id, title, to_tsvector('chinese', content) AS tsv
GIN索引需要目标列是 tsvector 类型，不能对 text 字段直接建 USING GIN
GIN 索引用于全文检索时，必须作用于 tsvector 值，而不是原始文本。如果你的物化视图里只存了 content TEXT，直接写 CREATE INDEX ON my_mv USING GIN (content) 会失败，报错 data type text has no default operator class for access method "gin"。
解决路径：
• 在物化视图定义中预计算 tsvector：例如 to_tsvector('chinese', coalesce(content, '')) AS tsv
• 或者用表达式索引（无需改 MV 定义）：CREATE INDEX idx_my_mv_tsv ON my_mv USING GIN (to_tsvector('chinese', coalesce(content, '')));
• 注意：表达式索引在查询时必须完全匹配该表达式才能命中，比如 WHERE to_tsvector('chinese', coalesce(content, '')) @@ to_tsquery('chinese', 'foo')
复合GIN索引不支持多列混合类型，但可对多个 tsvector 列建单个GIN索引
GIN 索引本身不区分“复合”逻辑——它本质是把多个列（或表达式）的向量值合并进一个倒排索引结构。你不能像 B-tree 那样建 (col_a, col_b) 的层级索引，但可以建一个覆盖多个 tsvector 字段的 GIN 索引：
• 正确写法：CREATE INDEX idx_mv_multi_tsv ON my_mv USING GIN (title_tsv, content_tsv);（要求 title_tsv 和 content_tsv 都是 tsvector 类型）
• 错误写法：CREATE INDEX ... ON my_mv USING GIN (title_tsv, content TEXT) —— 混合类型不被允许
• 性能提示：这种多列 GIN 索引适合同时在多个字段做全文匹配，例如 title_tsv @@ q OR content_tsv @@ q；但如果只查其中一个字段，它仍能生效，只是索引体积更大
并发刷新物化视图时，GIN索引会影响 REFRESH CONCURRENTLY 的可行性
REFRESH MATERIALIZED VIEW CONCURRENTLY 要求物化视图已有唯一索引（通常是主键或 UNIQUE 约束），而 GIN 索引本身不能作为这个“唯一性保障”。但更隐蔽的问题是：如果你在物化视图上建了表达式 GIN 索引（比如基于 to_tsvector(...)），刷新期间 PostgreSQL 会重写整个数据页，GIN 索引的维护开销可能显著拖慢刷新速度，尤其当 tsvector 值很大或文档极多时。
建议：
• 刷新前先 DROP INDEX，刷新完成后再 CREATE INDEX（适用于离线维护窗口）
• 若必须在线，优先用预计算列（如 tsv 字段）而非表达式索引，减少每次刷新时的重复计算
• 监控 pg_stat_progress_create_index 查看 GIN 构建是否卡在 “building index” 阶段
