// PostgreSQL 오류 참조

PostgreSQL 28P01: 비밀번호 인증 실패

PostgreSQL이 이 사용자의 비밀번호를 거부했습니다. 잘못된 비밀번호, 비밀번호가 없는 역할, 또는 서버가 더 이상 허용하지 않는 형식으로 해시된 비밀번호일 수 있습니다.

SQLSTATE
28P01
이름
invalid_password
카테고리
잘못된 인가 지정
오류 메시지
password authentication failed for user "app"

의미

서버가 발견한 것은 pg_hba.conf 규칙이 이 연결에 비밀번호를 요구합니다 (scram-sha-256, md5 또는 password)를 요구하는 규칙이 있고, 클라이언트가 보낸 비밀번호가 역할에 저장된 비밀번호와 일치하지 않았습니다.

보안 때문에 클라이언트에는 비밀번호가 틀렸다는 사실만 전해집니다. 이유는 서버 로그에 기록됩니다. 예: User "app" has no password assigned 또는 Role "app" does not exist.

일반적인 원인

  • 비밀번호가 틀렸거나, 연결 URL에서 특수 문자가 포함된 비밀번호가 손상됨(퍼센트 인코딩해야 함).
  • 역할이 존재하지 않거나 비밀번호가 설정되어 있지 않아도, 클라이언트는 여전히 password authentication failed.
  • 역할의 비밀번호가 MD5 해시로 저장되어 있지만 pg_hba.conf 필요로 하는 것은 다음 scram-sha-256, 업그레이드 후에는 기본값이 SCRAM이 됩니다.
  • 클라이언트가 다른 비밀번호를 가져온 곳은 PGPASSWORD 또는 .pgpass 파일.

해결 방법

  1. 로그인 실패에 대한 서버 로그 항목을 읽어 보세요. 진짜 이유가 적혀 있습니다.

  2. 슈퍼유저로 새 비밀번호를 설정하세요 (psql에서, \password app 입력 시 화면에 표시되지 않습니다).

    ALTER ROLE app WITH LOGIN PASSWORD 'new-strong-password';
  3. 비밀번호가 어떻게 저장되는지 확인하십시오. 값이 다음으로 시작하면 md5 전환 후에 재설정해야 합니다 password_encryption 에게 scram-sha-256.

    SHOW password_encryption;
    SELECT rolname, left(rolpassword, 14) AS hash_type
    FROM pg_authid WHERE rolname = 'app';
  4. 다음 중 어느 pg_hba.conf 줄이 일치했는지 확인하세요. 화면에는 서버가 불러온 파일이 그대로 표시됩니다.

    SELECT line_number, type, database, user_name, address, auth_method
    FROM pg_hba_file_rules;
  5. 연결 URL의 특수 문자는 퍼센트 인코딩합니다. 예를 들어 @ as %40: postgresql://app:p%40ss@db:5432/shop.

관련 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.