Node.js LinuxWindowsNode.js

Node.js: Скрипт Node.js не завершается из-за открытых соединений

  • Обновлено
  • Чтение ≈ 3 минуты

Краткий ответ

Одноразовый скрипт Node.js выполнил основную работу, но процесс продолжает существовать: его удерживают таймер, прослушивающий сервер, соединение с базой, сокет или незавершённый поток. Искать нужно активный ресурс, а не завершать процесс силой.

В этой статье
  1. Симптомы и условия возникновения
  2. Причины и как их отличить
  3. Пошаговая диагностика и решение
  4. Как проверить результат и что делать, если не помогло

#Симптомы и условия возникновения

Одноразовый скрипт Node.js выполнил основную работу, но процесс продолжает существовать: его удерживают таймер, прослушивающий сервер, соединение с базой, сокет или незавершённый поток. Искать нужно активный ресурс, а не завершать процесс силой. Для начала проверьте используемую версию среды и точный текст ошибки на копии проекта, не меняя рабочий сервер.

#Причины и как их отличить

Возможная причинаКак узнатьЧто делать
Незакрытый таймерВ этой ситуации наблюдается конкретный диагностический признак. Сопоставьте его с журналом ошибки и результатом соответствующей проверки, прежде чем выбирать исправление.В коде есть setInterval, выполняющийся после основной задачиОтменить таймер или использовать unref в подходящем сценарии.
Подключение остаётся открытымВ этой ситуации наблюдается конкретный диагностический признак. Сопоставьте его с журналом ошибки и результатом соответствующей проверки, прежде чем выбирать исправление.Процесс использует пул БД/HTTP-agent, сокет или серверКорректно закрыть подключение методом библиотеки.
Открытый серверВ этой ситуации наблюдается конкретный диагностический признак. Сопоставьте его с журналом ошибки и результатом соответствующей проверки, прежде чем выбирать исправление.Вызван listen, не был вызван closeВызвать server.close после завершения обслуживания.

#Пошаговая диагностика и решение

  1. 1. Убедитесь, что задача действительно закончиласьЗапустите сценарий на копии данных, дождитесь завершающего сообщения. Если оно не появляется, это зависание операции, а не открытый ресурс; смотрите незавершённый await или сетевой запрос.
  1. 2. Посмотрите типы активных ресурсовВ современных Node.js перед предполагаемым завершением временно вставьте process.getActiveResourcesInfo(). Вывод с Timeout намекает на таймер, с TCPServerWrap — на сервер; он не даёт точное имя объекта, поэтому сопоставьте с кодом.
  1. 3. Найдите таймер и его жизненный циклПоиск в редакторе проекта: setInterval, setTimeout, watch, createServer, createConnection. Для интервальных задач сохраняйте идентификатор и вызывайте clearInterval, когда проверка закончена. Не добавляйте process.exit(0) вместо закрытия файлов/сокетов.
  1. 4. Закройте сервер без обрыва активных запросовДля собственного HTTP-сервера после окончания сценария вызовите server.close() и дождитесь обратного вызова. Он прекращает приём новых подключений и завершает обслуживание; работа с активными запросами требует учёта версии Node и тайм-аутов.
  1. 5. Завершите работу пула БДУзнайте используемую библиотеку (например, pg или mysql2) и вызовите её документированный метод завершения (pool.end() для этих пакетов) в finally. Если подключение было создано где-то ещё, убедитесь, что закрывает его владелец; не уничтожайте разделяемый пул во время работы API.
  1. 6. Проверьте оставшийся список ресурсовПовторно выведите process.getActiveResourcesInfo() и найдите оставшиеся ресурсы. Не путайте стандартные TTY и инфраструктурные дескрипторы отладки с ошибкой скрипта.
  1. 7. Проверьте естественное завершениеЗапустите скрипт без отладчика и убедитесь, что командная строка вернулась без принудительного kill. Если не вернулась, верните изменение и по одному отключайте собственные компоненты на тестовой копии.
  2. Пример кода по теме
    Текст
    Покажите в отдельной тестовой ветке; server должен ссылаться на ваш экземпляр HTTP-сервера.
    console.log('Активные ресурсы:', process.getActiveResourcesInfo());
// Для собственного сервера после окончания обслуживания:
server.close((error) => {
  if (error) console.error('Не удалось закрыть сервер:', error);
});

#Как проверить результат и что делать, если не помогло

После завершения всех задач процесс сам освобождает ресурсы, возвращает управление терминалу, записи в БД/файлах сохранены.

Если неисправность повторилась, выпишите первый код ошибки и действие, на котором она возвращается. Сравните версию Node.js/npm, рабочий каталог, настройки процесса и журнал тестового запуска. Откатите только внесённые изменения из предварительно сохранённой копии, затем разберите причину на отдельной среде.

Так эту ошибку тоже называют

Node.js: Error: listen EADDRINUSE :::3000 — причины и решение Остановите процесс, занявший порт, или смените порт. Программирование и базы данных Node.js LinuxWindowsmacOS Node.js: JavaScript heap out of memory — причины и решение Увеличьте --max-old-space-size и найдите утечку. Программирование и базы данных Node.js LinuxWindowsmacOS Node.js: Cannot use import statement outside a module — причины и решение Ошибка возникает при использовании import в CommonJS-файле. Укажите "type": "module" в package.json или переименуйте файл в .mjs. Программирование и базы данных Node.js LinuxWindowsmacOS Node.js: FATAL ERROR: JavaScript heap out of memory — причины и решение «FATAL ERROR: JavaScript heap out of memory» в Node.js возникает, когда процесс исчерпал лимит памяти V8. Увеличьте --max-old-space-size, найдите утечку, обрабатывайте д… Программирование и базы данных Node.js LinuxWindowsmacOS Node.js: The engine "node" is incompatible with this module — причины и решение Проект требует другую версию Node.js, чем установлена. Ниже — причины и порядок действий от простого к сложному. Программирование и базы данных Node.js WindowsLinux

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.