DockerでPostgreSQLを運用しているのだが、メンテナンスのためにDBを停止しようとして、誤ってCtrl-Cを連打してしまい強制終了してしまった。
慌てて再起動を試みるも、次のようなエラーで起動しなくなっていた。

2021-08-27 16:16:22.532 UTC [1] LOG:  starting PostgreSQL 13.4 (Debian 13.4-1.pgdg100+1) on aarch64-unknown-linux-gnu, compiled by gcc (Debian 8.3.0-6) 8.3.0, 64-bit
2021-08-27 16:16:22.532 UTC [1] LOG:  listening on IPv4 address "0.0.0.0", port 5432
2021-08-27 16:16:22.532 UTC [1] LOG:  listening on IPv6 address "::", port 5432
2021-08-27 16:16:22.536 UTC [1] LOG:  listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
2021-08-27 16:16:22.542 UTC [27] LOG:  database system was shut down at 2021-08-27 16:13:35 UTC
2021-08-27 16:16:22.543 UTC [27] LOG:  invalid primary checkpoint record
2021-08-27 16:16:22.543 UTC [27] PANIC:  could not locate a valid checkpoint record
2021-08-27 16:16:22.710 UTC [1] LOG:  startup process (PID 27) was terminated by signal 6: Aborted
2021-08-27 16:16:22.710 UTC [1] LOG:  aborting startup due to startup process failure
2021-08-27 16:16:22.712 UTC [1] LOG:  database system is shut down

ポイントは7行目の

PANIC:  could not locate a valid checkpoint record

で、Stack Overflow¹によるとWAL（トランザクションログ）が壊れているらしい。

データのバックアップを取った後に、以下のコマンドでWALをリセットして復旧を試みる（PostgreSQL 9まではpg_resetxlogというコマンドだったらしい）。

pg_resetwal /var/lib/postgresql/data

Docker Composeで停止中のコンテナに対して実行する場合は以下の通り。
DB_USER_NAMEは、PostgreSQLの起動時に環境変数POSTGRES_USERで指定したユーザー名（デフォルトはpostgres）。
COMPOSE_SERVICE_NAMEは、docker-compose.ymlで指定したデータベースコンテナのサービス名。

docker compose run --user=DB_USER_NAME COMPOSE_SERVICE_NAME pg_resetwal /var/lib/postgresql/data

コマンドの実行後はデータ破損がないか確認し、必要に応じて修正を行うこと。私の環境では現在のところ正常に稼働している。

https://stackoverflow.com/questions/66537747/ ↩