PostgreSQL修复paperless-ngx数据库：重建索引遇并发插入问题求助

问题背景 #

你遇到的是PostgreSQL的TOAST数据损坏错误，修复时因存在活跃连接导致无法完成重索引，以下是一步步的操作说明：

步骤1：进入PostgreSQL容器的命令行 #

• 先查数据库容器名称：运行 docker ps，找到标注为postgres的容器（通常名字是类似paperless_db_1的格式）
• 进入容器：把下面的[容器名称]换成你查到的名字，执行

  docker exec -it [容器名称] bash
  

• 切换到postgres管理用户：

  su - postgres
  

• 进入PostgreSQL命令行工具：

  psql
  

步骤2：终止所有访问django_q_task表的活跃进程 #

• 查询当前正在访问该表的进程：

  SELECT pid, query FROM pg_stat_activity WHERE relname = 'django_q_task' AND state = 'active';
  

  执行后会列出进程ID（pid列）和正在执行的操作
• 逐个终止这些进程，把[pid]换成查到的进程号，重复执行直到没有结果：

  SELECT pg_terminate_backend([pid]);
  

步骤3：锁定表并修复损坏 #

• 给表加排他锁（确保无其他操作干扰）：

  LOCK TABLE django_q_task IN EXCLUSIVE MODE;
  

• 尝试重索引修复：

  REINDEX (VERBOSE) TABLE django_q_task;
  

  如果执行完没有报错，直接跳到步骤4验证

如果重索引仍失败（TOAST损坏严重）：

这种情况只能丢弃损坏的行（丢失的是django_q的任务数据，paperless重启后可能需要重新提交未完成的任务）

• 创建临时表，复制未损坏的数据：

  CREATE TABLE django_q_task_temp AS SELECT * FROM django_q_task WHERE id NOT IN (
      SELECT oid FROM pg_toast.pg_toast_2619 WHERE chunk_id = 52399
  );
  

• 替换原表：

  ALTER TABLE django_q_task RENAME TO django_q_task_old;
  ALTER TABLE django_q_task_temp RENAME TO django_q_task;
  

• 恢复原表的主键和索引（paperless依赖这些结构运行）：

  ALTER TABLE django_q_task ADD PRIMARY KEY (id);
  CREATE INDEX django_q_task_created_at_idx ON django_q_task (created_at);
  CREATE INDEX django_q_task_lock_idx ON django_q_task (lock);
  CREATE INDEX django_q_task_scheduled_at_idx ON django_q_task (scheduled_at);
  

• 确认没问题后可删除旧表：

  DROP TABLE django_q_task_old;
  

步骤4：验证修复结果 #

• 执行查询测试表是否正常读取：

  SELECT COUNT(*) FROM django_q_task;
  

• 退出PostgreSQL命令行：\q，然后退出容器：exit
• 启动所有paperless相关容器，测试是否还出现之前的错误

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