// 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 内の特殊文字をパーセントエンコードします。例: @ として %40: postgresql://app:p%40ss@db:5432/shop.

関連エラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。