Node.js: Error: connect ECONNREFUSED 127.0.0.1 — приложение не подключается к базе
Приложение попыталось подключиться к адресу и порту, а там никто не принимает подключения. По номеру порта в сообщении видно, к чему оно подключалось: к PostgreSQL, MySQL, Redis или другой программе.
Содержание 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.
К чему подключалось приложение
| Порт | Программа | Подробно |
|---|---|---|
| 5432 | PostgreSQL | PostgreSQL: Connection refused |
| 3306 | MySQL или MariaDB | MySQL: Can't connect to server |
| 6379 | Redis | Как установить Redis на Ubuntu |
| другой | другая служба или ваше же приложение | шаги ниже |
Шаг 1. Проверьте, запущена ли служба
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
Имя службы зависит от программы:
| Программа | Команда |
|---|---|
| PostgreSQL | sudo systemctl status postgresql |
| MySQL | sudo systemctl status mysql |
| MariaDB | sudo systemctl status mariadb |
| Redis | sudo 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. Подставьте свои.
Источники
- Исходный код Node.js 18.19.1: lib/internal/errors.js — вид сообщения connect ECONNREFUSED адрес:порт и свойства errno, code, syscall, address, port.
- Исходный код Node.js 22.22.1: lib/net.js — при нескольких адресах ошибки собираются в AggregateError.
- Исходный код Node.js 22.22.1: src/node_options.h — перебор адресов IPv6 и IPv4 включён по умолчанию, в Node.js 18 он выключен.
- Документация Node.js 22: net — autoSelectFamily: попытки по очереди к адресам IPv6 и IPv4.
- Исходный код iproute2 6.1.0: misc/ss.c — адреса IPv6 в квадратных скобках.
Сверено 22 октября 2026 года.