PostgreSQL「lock file already exists（postmaster.pid）」の原因と安全な解決手順【完全版】

FATAL:  lock file "postmaster.pid" already exists
HINT:  Is another postmaster (PID 1234) running in data directory "/var/lib/postgresql/16/main"?

# 接続可否（ローカル）
pg_isready -h 127.0.0.1 -p 5432

# バージョン取得
psql -h 127.0.0.1 -p 5432 -U postgres -c "select version();"

# プロセス確認（Linux/macOS）
ps aux | grep '[p]ostgres'

# systemd
sudo systemctl status postgresql

# Homebrew (macOS)
brew services list

# Windows（管理者PowerShell）
sc query "postgresql-x64-16"

# ロックファイルの場所（例）
echo $PGDATA
ls -l "$PGDATA/postmaster.pid"

# PIDの確認（1行目）
head -1 "$PGDATA/postmaster.pid"

# 1) サーバの状態確認
pg_ctl -D "$PGDATA" status

# 2) 稼働中なら安全に停止
pg_ctl -D "$PGDATA" stop -m fast

# 3) 停止を確認（必要なら数秒待つ）
pg_ctl -D "$PGDATA" status

# 4) 起動
pg_ctl -D "$PGDATA" start

# systemd
sudo systemctl stop postgresql
sudo systemctl start postgresql

# Homebrew
brew services restart postgresql@16

PID="$(head -1 "$PGDATA/postmaster.pid")"
if kill -0 "$PID" 2>/dev/null; then
  echo "PostgreSQLはPID $PIDで稼働中。削除禁止。"
else
  echo "PIDが存在しない → ロックは孤児の可能性。"
fi

# 念のためバックアップ
cp -a "$PGDATA/postmaster.pid" "$PGDATA/postmaster.pid.bak.$(date +%s)"

# 削除（サーバ非稼働が前提）
rm -f "$PGDATA/postmaster.pid"

# 再起動
pg_ctl -D "$PGDATA" start

# 停止
net stop "postgresql-x64-16"

# もし停止済みなのに postmaster.pid が残っている場合
copy "C:\Program Files\PostgreSQL\16\data\postmaster.pid" "C:\Program Files\PostgreSQL\16\data\postmaster.pid.bak"
del  "C:\Program Files\PostgreSQL\16\data\postmaster.pid"

# 起動
net start "postgresql-x64-16"

"C:\Program Files\PostgreSQL\16\bin\pg_ctl.exe" -D "C:\Program Files\PostgreSQL\16\data" stop -m fast
"C:\Program Files\PostgreSQL\16\bin\pg_ctl.exe" -D "C:\Program Files\PostgreSQL\16\data" start

# Debian/Ubuntu系
/var/lib/postgresql/16/main

# RHEL/CentOS系
/var/lib/pgsql/16/data

# Homebrew (Apple Silicon)
 /opt/homebrew/var/postgres

# Windows 例
C:\Program Files\PostgreSQL\16\data

# 所有者と権限（Linux）
sudo chown -R postgres:postgres "$PGDATA"
sudo chmod 700 "$PGDATA"

# 空き容量
df -h

# systemd（ユニット名は環境により postgresql@16-main 等）
sudo systemctl status postgresql
sudo systemctl stop postgresql
sudo systemctl start postgresql
sudo journalctl -u postgresql -e

# Homebrew
brew services list
brew services restart postgresql@16
tail -n 200 $(brew --prefix)/var/log/postgres.log

# Docker
docker ps | grep postgres
docker logs <container_id>
docker stop <container_id>; docker start <container_id>

# Kubernetes
kubectl get pods -n <ns> -l app=postgres
kubectl logs <pod> -n <ns>

#!/usr/bin/env bash
set -euo pipefail

: "${PGDATA:=/var/lib/postgresql/16/main}"   # 環境に合わせて修正
: "${PGPORT:=5432}"

echo "[*] PGDATA = $PGDATA"
if pg_isready -h 127.0.0.1 -p "$PGPORT" >/dev/null 2>&1; then
  echo "[*] PostgreSQLは稼働中。処理を終了します。"
  exit 0
fi

if [ -f "$PGDATA/postmaster.pid" ]; then
  PID="$(head -1 "$PGDATA/postmaster.pid" || true)"
  if [ -n "${PID:-}" ] && kill -0 "$PID" 2>/dev/null; then
    echo "[!] PID $PID が生存。停止してから再実行してください。"
    exit 1
  fi
  echo "[*] ステールロックをバックアップし削除します。"
  cp -a "$PGDATA/postmaster.pid" "$PGDATA/postmaster.pid.bak.$(date +%s)"
  rm -f "$PGDATA/postmaster.pid"
fi

echo "[*] 所有権/権限の健全性を確認します。"
sudo chown -R postgres:postgres "$PGDATA"
sudo chmod 700 "$PGDATA"

echo "[*] PostgreSQLを起動します。"
sudo -u postgres pg_ctl -D "$PGDATA" -l "$PGDATA/server.log" start

echo "[*] 起動確認："
pg_isready -h 127.0.0.1 -p "$PGPORT"

$ServiceName = "postgresql-x64-16"
$DataDir     = "C:\Program Files\PostgreSQL\16\data"

sc query $ServiceName
if ((Get-Service $ServiceName).Status -eq "Running") {
  Write-Host "PostgreSQLは稼働中。処理を終了。"
  exit
}

$postmaster = Join-Path $DataDir "postmaster.pid"
if (Test-Path $postmaster) {
  $pid = Get-Content $postmaster | Select-Object -First 1
  try {
    $p = Get-Process -Id $pid -ErrorAction Stop
    Write-Host "PID $pid が稼働中。サービスを停止してから再実行してください。"
    exit
  } catch {
    Copy-Item $postmaster "$($postmaster).bak.$([int][double]::Parse((Get-Date -UFormat %s)))"
    Remove-Item $postmaster -Force
  }
}
Start-Service $ServiceName