PostgreSQL 18 마이그레이션 실패 시 점검해야 할 핵심 체크리스트

요약

본 문서는 PostgreSQL 18로 마이그레이션 직후 발생할 수 있는 주요 문제점과 체계적인 해결 방법을 안내합니다. 클러스터의 물리적 상태 확인, `pg_controldata`를 이용한 오프라인 진단, 그리고 PG 18에서 변경된 기본 설정값(예: data_checksums)을 점검하는 등 증상별로 접근해야 할 핵심 포인트를 제시합니다.

핵심 포인트

• 마이그레이션 실패 시, 클러스터의 물리적 상태와 체크섬 일치 여부를 최우선으로 확인하세요.
• `pg_controldata`는 연결 불가 상황에서도 데이터 디렉토리에서 시스템 정보를 읽어낼 수 있습니다.
• PG 18에서는 data_checksums, password_encryption 등 기본값이 변경되었으므로 반드시 점검해야 합니다.
• 증상(연결 오류/느린 속도)에 따라 `pg_hba.conf` 인증 방식이나 실행 계획 차이점을 체계적으로 분석하세요.