async function shutdown() { await new Promise((resolve, reject) => { server.close(error…
- User
async function shutdown() { await new Promise((resolve, reject) => { server.close(error => { if (error) { console.error("Error:", error); reject(error); } else { resolve(); } }); }); await ctx.dispose(); await buildWatcher.close(); await staticWatcher.close(); console.log("Graceful Shutdown."); }
process.on('SIGINT', shutdown); process.on('SIGTERM', shutdown); process.on('SIGQUIT', shutdown); process.on('SIGBREAK', shutdown);а чего в консоль не пишет? Это норма?
- Assistant
Нет, это не совсем норма, если при попытке завершения процесса ничего не выводится в консоль — даже
console.log("Graceful Shutdown."). Это может говорить о том, что:
🔍 Возможные причины
1.
shutdownне вызываетсяЕсли
shutdown()вообще не вызывается, значит сигнал (SIGINT,SIGTERMи т.д.) не доходит до обработчика.SIGINT— вызывается при нажатииCtrl + Cв терминале.SIGTERM,SIGQUIT,SIGBREAK— в других случаях (например,killиз другого процесса).
Проверь:
- Убедись, что процесс не блокирует сигнал.
- Убедись, что ты запускаешь скрипт в реальном терминале, а не в каком-то обёрточном окружении (например, внутри некоторых IDE обработка сигналов может быть странной).
2. Обработка сигнала работает, но что-то "висит"
Внутри
shutdown()ты используешь асинхронные действия:await new Promise((resolve, reject) => { server.close(error => { ... }); });Если при попытке завершить, например,
server.close()не завершается (например, если кто-то всё ещё держит соединение) — промис никогда не резолвится и следующая строка (await ctx.dispose();) не вызывается. Соответственно, иconsole.log("Graceful Shutdown.")не произойдёт.Проверь:
- Возможно, нужно добавить таймаут на
server.close()или логгирование внутри обработчика завершения, чтобы понять, повис ли этот промис.
3. Процесс аварийно завершается до вызова
console.logЕсли какой-то объект (например,
ctx.dispose()илиbuildWatcher.close()) бросает исключение, и ты его не ловишь, то асинхронная ошибка может "поглотиться" и завершить процесс без вывода, если ты не используешьtry/catch.
✅ Как отладить
Добавь логгирование на каждом этапе:
async function shutdown() { console.log("Shutdown signal received"); try { console.log("Closing server..."); await new Promise((resolve, reject) => { server.close(error => { if (error) { console.error("Server close error:", error); reject(error); } else { console.log("Server closed."); resolve(); } }); }); console.log("Disposing ctx..."); await ctx.dispose(); // тут тоже может выброситься ошибка console.log("Closing buildWatcher..."); await buildWatcher.close(); console.log("Closing staticWatcher..."); await staticWatcher.close(); console.log("Graceful Shutdown."); } catch (err) { console.error("Shutdown error:", err); } finally { process.exit(0); // Обязательно завершай процесс вручную, если ожидаешь "мягкое" завершение. } }
💡 Рекомендации
- Всегда оборачивай
shutdownвtry/catchи логируй ошибки. - В некоторых случаях process может не завершаться самостоятельно — добавляй
process.exit(0)илиprocess.exit(1)вfinally. - Используй
console.logперед каждым существенным действием — поможет отследить, на чём зависает.
Если после всех правок ты по-прежнему не видишь сообщений, попробуй вызвать
shutdown()напрямую в коде и проверь консоль — так можно изолировать проблему.Если хочешь, покажи больше контекста — где объявлен
server,ctx,buildWatcher, — я помогу точнее. - User
Хмм вот так вызывается.
async function shutdown() { console.log("Graceful Shutdown."); await new Promise((resolve, reject) => { server.close(error => { if (error) { console.error("Error:", error); reject(error); } else { resolve(); } }); }); await ctx.dispose(); await buildWatcher.close(); await staticWatcher.close(); }
- Assistant
Понял тебя! Ты говоришь, что функция
shutdown()вот с таким содержимым вызывается по сигналам, ноconsole.log("Graceful Shutdown.")не выводится в консоль. То есть первое сообщение внутриshutdownне появляется ✅
🎯 Значит, в данном случае:
process.on('SIGINT', shutdown); process.on('SIGTERM', shutdown); // и т.д.Ты ожидаешь, что при
Ctrl+Cилиkill <pid>, начнётся graceful shutdown и ты увидишь:Graceful Shutdown.Но этого не происходит.
💡Следовательно —
shutdown()вообще не вызывается 🎯
💥 Точная причина чаще всего — такая:
🚨 Node.js не вызывает обработчик сигналов, если:
- процесс неактивен взаимодействием с терминалом;
- процесс не слушает stdin / stdout;
- используется среда запуска, которая не передаёт сигнал CTRL+C (SIGINT) штатно:
- некоторых shell-обёртках,
- в задачах типа
npm run(зависит от оболочки), - в IDE (например, в WebStorm/VSCode консоль иногда не очень UNIX-совместима),
- в systemd, docker и т.д.
✅ Проверь (чеклист):
1. 🔄 Попробуй вручную вызвать
shutdown():(async () => { await shutdown(); // ✅ должен увидеть 'Graceful Shutdown.' })();Если это работает — значит проблема не в
shutdown(), а в обработке сигналов.
2. 🔌 Убедись, что процесс живёт (не сразу завершился)
Простейшая задержка, чтобы процесс не умер мгновенно:
setInterval(() => {}, 1000); // Пустая задержкаТ.к. если у тебя
server.listen()или другие активности уже завершились, Node сам завершает процесс, и не обрабатывает сигнал.
3. 💻 Проверь
SIGINT(Ctrl+C) в простом примере:Создай такой временный файл
signal-test.js:process.on('SIGINT', () => { console.log('Caught SIGINT'); process.exit(0); }); console.log("Waiting... Press Ctrl+C"); setInterval(() => {}, 1000); // чтобы процесс жилЗапусти через терминал:
node signal-test.jsНажми
Ctrl+C. Ты должен увидеть:Caught SIGINTЕсли нет — проблема в твоей терминальной среде/оболочке.
4. ⚙️ Проверь, не “теряется” ли сигнал внутри launcher’а
Если ты запускаешь, например, как:
npm run devИ это делает:
"scripts": { "dev": "node server.js" }Попробуй заменить на прямой запуск:
node server.jsИногда npm оборачивает процесс и плохо прокидывает сигналы.
5. ☠️Если запускаешь через Docker / pm2 / systemd — там отдельные особенности:
Пингани, если ты в таких условиях — дам точные рекомендации.
✔️ Как протестировать
SIGTERM,SIGQUITи т.д.Найди PID процесса:
ps aux | grep nodeДопустим PID = 12345, отправь сигнал:
kill -SIGTERM 12345И смотри на поведение.
✅ Финальный совет:
Добавь такой лог на верх уровня:
console.log("Started process with PID", process.pid);А ещё надежный код:
const shutdown = async () => { console.log("Shutdown signal received"); try { console.log("Closing server..."); await new Promise((resolve, reject) => { server.close(error => { if (error) reject(error); else resolve(); }); }); console.log("Disposing ctx..."); await ctx.dispose(); console.log("Closing watchers..."); await buildWatcher.close(); await staticWatcher.close(); console.log("Graceful shutdown complete"); process.exit(0); // <-- обязательно завершай сам, вдруг что зависнет } catch (err) { console.error("Error during shutdown:", err); process.exit(1); } }; process.on('SIGINT', shutdown); process.on('SIGTERM', shutdown);
📌Вывод: скорее всего, либо сигнал не доходит до
process.on(...), либо процесс уже мертв к моменту сигнала.Проверь stdout, среду запуска и поведение — тогда станет ясно.
Если хочешь — можешь прислать, как именно ты запускаешь скрипт (полную команду, структуру), и я подскажу точно.
- User
console.log("Closing server..."); await new Promise((resolve, reject) => { server.close(error => { if (error) { console.error("Server close error:", error); reject(error); } else { console.log("Server closed."); resolve(); } }); }); процесс видимо зависает вот тут. Как так? Может просто server.close?
- Assistant
Да, ты очень верно подсмотрел, и, похоже, двигаешься в правильном направлении 🧠
Если процесс “зависает” на:
await new Promise((resolve, reject) => { server.close(error => { if (error) { console.error("Server close error:", error); reject(error); } else { console.log("Server closed."); resolve(); } }); });то действительно — это почти наверняка значит:
❗
server.close(...)никогда не вызывает колбэк!А значит:
await new Promise()— висит вечно →shutdown()не продолжается →console.log("Graceful Shutdown.")не вызывается.
💡 Почему
server.close()может зависать?В Node.js
server.close():- останавливает приём новых подключений, но...
- ждёт закрытия ВСЕХ активных соединений, прежде чем вызвать твой
callback.
То есть: если у тебя есть висящие/долго живущие соединения (например,
keep-alive,websocket,SSEи пр.),server.close()не завершится никогда, пока ты их явно не закроешь вручную.
✅ Как это можно пофиксить?
Вариант 1: 👉 Принудительно закрыть все соединения
Ты можешь отслеживать все открытые сокеты, и закрывать их вручную при
shutdown:const sockets = new Set(); server.on('connection', socket => { sockets.add(socket); socket.on('close', () => { sockets.delete(socket); }); });А в
shutdown():for (const socket of sockets) { socket.destroy(); // Принудительное закрытие }Тогда
server.close()сможет наконец "отпустить" колбэк.
Вариант 2: 👉 Добавить таймаут на
server.closeЭто «грубее», но иногда быстрее для клиенских утилит:
await Promise.race([ new Promise((resolve, reject) => { server.close(err => { if (err) reject(err); else resolve(); }); }), new Promise((_, reject) => setTimeout(() => reject(new Error('server.close timeout')), 5000) ) ]);Тогда shutdown не зависнет бесконечно.
🔍 Ещё: как проверить, действительно ли висят подключения?
В отдельной вкладке/терминале можешь зайти с любым
curl:curl http://localhost:3000Если сервер поддерживает
keep-alive, он будет держать открытое соединение.На сервере можно ещё проверить, сколько активных соединений:
server.getConnections((err, count) => { console.log('Active connections:', count); });
🧠 Полный пример
const sockets = new Set(); server.on('connection', socket => { sockets.add(socket); socket.on('close', () => sockets.delete(socket)); }); async function shutdown() { console.log("Shutdown signal received"); try { console.log("Closing server..."); for (const socket of sockets) { socket.destroy(); // Закрывает все соединения } await new Promise((resolve, reject) => { server.close(error => { if (error) { console.error("Server close error:", error); reject(error); } else { console.log("Server closed."); resolve(); } }); }); await ctx.dispose(); await buildWatcher.close(); await staticWatcher.close(); console.log("Graceful Shutdown."); process.exit(0); } catch (err) { console.error("Error during shutdown:", err); process.exit(1); } }
✍️ Вывод
server.close()ждет, пока все соединения закроются.- Если у тебя
keep-aliveилиwebsockets— процесс зависает. - Лечится либо
socket.destroy(), либоPromise.raceс таймаутом.
Хочешь — могу подсказать адаптацию под
Express,Fastify,Koaи т.п., если используешь фреймворк. - User
А ведь server это uWS.App.
- Assistant
🧠Отлично что уточнил! 👉 Если
server— этоuWS.AppизuWebSockets.js, то всё встает на свои места.
🧨 Проблема:
uWS.App— это не Node.js HTTP серверconst server = uWS.App().listen(...);serverздесь — это не объект с методомclose(callback), как в стандартномhttp.createServer.- Поэтому вот такое написание:
await new Promise((resolve, reject) => { server.close(err => { ... }); // ❌ НЕ РАБОТАЕТ });➡️ не работает, и ты никогда не получишь
resolve(), потому чтоserver.close(...)🟥 не принимает колбэк.
✅ Как правильно остановить uWebSockets сервер
В uWebSockets.js
listen(...)возвращает объект с методом:const server = app.listen(port, token => { if (token) { console.log(`Listening on port ${port}`); } });Но
serverвот тут — это token (по сути, "handle") и у него есть методclose(), без аргументов и без колбэков. Он синхронный:server.close(); // ⛔ не возвращает Promise, не принимает колбэкПоэтому shutdown должен быть простой и прямолинейный:
server.close();И не нужно оборачивать его в промис.
✅ Как переписать
shutdown()подuWS.Appasync function shutdown() { console.log("Shutdown signal received"); try { console.log("Closing uWS server..."); server.close(); // 👈 просто вызывается, без await console.log("Disposing context..."); await ctx.dispose(); console.log("Closing file watchers..."); await buildWatcher.close(); await staticWatcher.close(); console.log("Graceful Shutdown complete."); process.exit(0); } catch (err) { console.error("Error during shutdown:", err); process.exit(1); } }
🚨 Важно:
- вызов
server.close()сразу прекращает приём новых соединений, но: - активные соединения закрываются немедленно, потому что
uWSне предоставляет структуру подключения к сокетам, какnet.Server.
Т.е. —
uWebSockets.jsспроектирован быть "агрессивным" при закрытии: он скорее всего сам форсирует shutdown.
🔎 Дополнительно — проверить, что такое
serverЕсли вдруг не уверен, что именно возвращает
app.listen(...), можно воткнуть:console.log("Server object:", server);и увидеть, есть ли у него
.close:console.log("Has close:", typeof server.close);Или так:
if (typeof server.close === 'function') { server.close(); }
🧾 Итого
Что Нужно понимать uWS.App()не возвращает "Node-style" сервер server.close()синхронный метод, без колбэка и без промисов shutdown()не оборачивай close()вnew Promise(...)Зависание происходит, потому что промис не резолвился
Если хочешь, могу показать полный шаблон
graceful shutdownименно подuWebSockets.js, например с WebSocket'ами или SSE.
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.