// справочник ошибок PostgreSQL

PostgreSQL 08001: невозможно установить соединение

Клиенту вообще не удалось открыть соединение с сервером: на этом хосте и порте никто не слушает, мешает брандмауэр, DNS или тайм-аут.

SQLSTATE
08001
Имя
sqlclient_unable_to_establish_sqlconnection
Категория
Сбой подключения
Сообщение об ошибке
connection to server at "db.example.com" (10.0.0.5), port 5432 failed: Connection refused
	Is the server running on that host and accepting TCP/IP connections?

Что это значит

08001 — это SQLSTATE на стороне клиента: драйверы, такие как PgJDBC и Npgsql, сообщают о нём, когда не удаётся установить соединение, а инструменты на базе libpq выводят сообщения, подобные приведённому выше. Сервер так и не увидел попытку входа, поэтому проблема в сетевом пути или том, что сервер не слушает, а не в учётных данных.

Ошибка операционной системы в конце сообщения говорит, какая именно: Connection refused означает, что хост ответил, но на этом порту никто не слушает; timeout expired или Operation timed out обычно означает, что брандмауэр отбросил пакеты; could not translate host name — это DNS.

Распространённые причины

  • Сервер PostgreSQL не запущен или слушает другой порт.
  • listen_addresses является localhost (по умолчанию), поэтому сервер принимает только локальные соединения.
  • Брандмауэр, группа безопасности или проброс порта Docker блокируют порт 5432.
  • Неправильное имя хоста или имя хоста, которое клиент не может разрешить.
  • Подключение к localhost изнутри контейнера, что относится к самому контейнеру.

Как исправить

  1. На сервере проверьте, что PostgreSQL запущен и на каких адресах и порту он слушает.

    SHOW listen_addresses;
    SHOW port;
  2. Разрешите сетевые подключения: установите listen_addresses = '*' (или адрес сервера) в postgresql.conf и перезапустите, затем добавьте pg_hba.conf правило для клиентов.

  3. Проверьте сетевой путь с клиента, например pg_isready -h db.example.com -p 5432, и откройте порт в брандмауэре или группе безопасности.

  4. Из контейнера подключайтесь к имени сервиса контейнера базы данных или к адресу хоста вместо localhost.

Связанные ошибки

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.