Поиск
Ошибки

Node.js: Error: connect ECONNREFUSED 127.0.0.1 — приложение не подключается к базе

Приложение попыталось подключиться к адресу и порту, а там никто не принимает подключения. По номеру порта в сообщении видно, к чему оно подключалось: к PostgreSQL, MySQL, Redis или другой программе.

≈ 5 мин чтения3 шага
Содержание 9

Как выглядит ошибка

Error: connect ECONNREFUSED 127.0.0.1:5432
    at … {
  errno: -111,
  code: 'ECONNREFUSED',
  syscall: 'connect',
  address: '127.0.0.1',
  port: 5432
}

После слова ECONNREFUSED — адрес и порт, куда подключалось приложение. Сервер ответил отказом: на этом порту ни одна программа не принимает подключения. Тексты ошибок сверены с исходным кодом Node.js 18.19.1 — он ставится из пакетов Ubuntu 24.04 — и Node.js 22.22.1 из пакетов Ubuntu 26.04.

К чему подключалось приложение

ПортПрограммаПодробно
5432PostgreSQLPostgreSQL: Connection refused
3306MySQL или MariaDBMySQL: Can't connect to server
6379RedisКак установить Redis на Ubuntu
другойдругая служба или ваше же приложениешаги ниже

Шаг 1. Проверьте, запущена ли служба

Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.

Имя службы зависит от программы:

ПрограммаКоманда
PostgreSQLsudo systemctl status postgresql
MySQLsudo systemctl status mysql
MariaDBsudo systemctl status mariadb
Redissudo systemctl status redis-server

Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — так и должно быть: наберите пароль и нажмите Enter. На вопрос Do you want to continue? [Y/n] нажмите Y и Enter. В строке Active должно быть active (running). Если там inactive или failed, запустите службу и включите её запуск вместе с сервером — на примере PostgreSQL:

sudo systemctl start postgresql
sudo systemctl enable postgresql

Если служба не запускается, причина — в её журнале: sudo journalctl -u postgresql -n 50 (команда journalctl). Если systemctl пишет, что такой службы нет, база на этом сервере не установлена — Unit not found.

Шаг 2. Проверьте адрес и порт

Посмотрите, на каком адресе программа ждёт подключения, — для порта 5432:

sudo ss -ltnp | grep 5432

В четвёртой колонке — адрес и порт:

В колонкеЧто значит
127.0.0.1:5432программа слушает только IPv4-адрес 127.0.0.1
[::1]:5432только IPv6-адрес ::1
0.0.0.0:5432все IPv4-адреса сервера
[::]:5432все IPv6-адреса сервера
*:5432все адреса сервера, IPv4 и IPv6

Если строк нет, на этом порту никто не слушает: служба остановлена или настроена на другой порт. Порт задают в файле настроек самой программы.

Шаг 3. Если в сообщении адрес ::1

Сообщение connect ECONNREFUSED ::1:3306 значит, что Node.js подключался по IPv6-адресу ::1. Так бывает, когда в настройках приложения указан адрес localhost. Если на шаге 2 база видна на 127.0.0.1, замените в настройках подключения localhost на 127.0.0.1 — в файле .env или в конфиге приложения. Посмотреть строки с адресом и портом:

grep -i -E "host|port" /home/ivan/myapp/.env

В Node.js 22 при адресе localhost Node.js пробует по очереди оба адреса — ::1 и 127.0.0.1. Если не ответил ни один, в сообщении будет слово AggregateError и ошибки по обоим адресам. Это значит, что служба не запущена или слушает другой порт — вернитесь к шагу 1.

Если приложение в Docker

Внутри контейнера адрес 127.0.0.1 — это сам контейнер, а не сервер. Если база запущена в соседнем контейнере через docker compose, указывайте в настройках приложения имя её службы из файла compose.yaml или docker-compose.yml, например db.

Как проверить

Перезапустите приложение и посмотрите журнал:

sudo systemctl restart myapp
sudo journalctl -u myapp -n 50

В журнале не должно быть строки ECONNREFUSED. Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше