PostgreSQL重建索引时出现索引行大小错误的问题排查

问题背景 #

我有一张包含主键和btree_gist索引的大表，运行数年后查询性能持续下降，推测gist索引存在碎片。执行REINDEX操作时（耗时约10小时，难以复现）出现错误：

ERROR:  index row size 80 exceeds maximum 8152 for index "idx_test1_id1_id2_validtime_systime"

表与索引定义 #

create table test1 (
   id1 bigint not null,
   id2 bigint not null,
   validtime tstzrange not null,
   systime tstzrange not null,
   data float);
CREATE INDEX idx_test1_id1_id2_validtime_systime ON test1
USING gist
(
   id1,
   id2,
   validtime,
   systime
)

困惑点 #

• gist索引的单行大小应为固定66字节，但重建时提示行大小为80
• 错误信息中80并未超过8152，逻辑矛盾

当前索引仍正常可用且被优化器使用，但重建操作失败，求排查方向。

版本信息 #

select version();
PostgreSQL 12.19 (Ubuntu 12.19-1.pgdg20.04+1) on x86_64-pc-linux-gnu, compiled by gcc (Ubuntu 9.4.0-1ubuntu1~20.04.2) 9.4.0, 64-bit

select extversion from pg_extension where extname='btree_gist';
1.5

排查提示 #

• 确认错误信息显示异常：错误提示的数值逻辑明显矛盾，大概率是PostgreSQL或btree_gist扩展的版本bug导致错误信息中的数值顺序反转，实际可能是索引行大小超出了某个内部限制（而非80>8152）。
• 排查表中异常数据：针对validtime和systime字段，检查是否存在无效范围值（如空边界、极端时间戳），这类数据可能在索引重建时触发特殊逻辑，导致索引行大小异常。可执行以下语句排查：

  SELECT * FROM test1 
  WHERE lower(validtime) IS NULL OR upper(validtime) IS NULL 
     OR lower(systime) IS NULL OR upper(systime) IS NULL;
  

• 验证btree_gist兼容性：查阅PostgreSQL 12.19与btree_gist 1.5组合的已知bug，确认是否存在REINDEX时的索引行大小计算问题。考虑升级btree_gist到适配PG12的最新小版本后重试。
• 分步重建索引：先创建临时gist索引测试是否能成功，逐步减少索引字段定位问题：

  -- 先创建完整临时索引
  CREATE INDEX idx_temp ON test1 USING gist(id1, id2, validtime, systime);
  -- 如果失败，尝试减少字段
  CREATE INDEX idx_temp ON test1 USING gist(id1, id2, validtime);
  

• 检查索引隐性损坏：通过SELECT * FROM pg_index WHERE indrelid = 'test1'::regclass;查看索引状态，或使用pg_checksums验证数据块完整性（注意该操作需提前规划，避免影响业务）。
• 导出导入数据验证：用pg_dump导出表数据，导入到新表后重建索引，排除原表数据文件的隐性损坏问题。

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