PostgreSQL跨版本恢复报index row size超btree version 4最大值错误

该报错由PostgreSQL跨大版本升级时B-tree索引规则变更导致：

• PostgreSQL 9.2 默认使用B-tree v3版本索引，单索引项最大允许大小为2712字节；PostgreSQL 12及以上版本默认启用B-tree v4版本索引，单索引项最大允许大小下调为2704字节，你备份文件中存在大小为2712字节的索引项，超出新版本上限导致索引创建失败。
• 恢复流程提示成功是因为pg_restore默认仅将表数据导入失败判定为致命错误，索引、约束创建失败不会终止恢复流程，但索引创建失败会导致关联表无法正常响应查询请求，表现为无可用访问数据。

1. 先完成基础数据导入 #

重新执行恢复操作，跳过索引和约束创建，优先保证表数据正常导入：

pg_restore -d 目标数据库名 --no-indexes --no-constraints 备份文件路径

导入完成后验证数据是否存在：

SELECT count(*) FROM 你的业务表名 LIMIT 1;

2. 调整问题索引规则 #

查询到创建失败的问题索引后，根据业务场景选择以下任意一种方案调整：

• 方案1：改用前缀索引。如果仅需要对长文本/长字符字段做前缀匹配查询，仅对字段前N个字符创建索引，控制索引项大小不超过2704字节：

CREATE INDEX 索引名 ON 表名 (left(长字段名, 500));

• 方案2：改用哈希索引。如果需要对字段做全值精确匹配，使用哈希索引规避B-tree的大小限制：

CREATE INDEX 索引名 ON 表名 USING hash (长字段名);

• 方案3：删除冗余索引。如果该索引无业务使用场景，直接删除无需重建。

3. 临时兼容方案（不推荐长期使用） #

如果问题索引数量较多无法快速逐个调整，可在PostgreSQL 13的配置文件postgresql.conf中添加如下配置，降级回B-tree v3版本兼容旧索引：

btree_version = 3

重启数据库实例后再重建所有索引即可，该参数仅在PostgreSQL 12~15版本支持，后续版本会逐步移除，仅适合临时过渡使用。

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