Урок 031 минута чтения
Что такое unhandledRejection и uncaughtException?
На этой странице
Кратко
unhandledRejection возникает, когда Promise отклонен и ошибка не обработана. uncaughtException возникает, когда исключение дошло до верхнего уровня и не было поймано.
Вопрос
Что такое unhandledRejection и uncaughtException и как правильно на них реагировать?
unhandledRejection
Promise.reject(new Error('Промис упал'));
process.on('unhandledRejection', (reason) => {
console.error('Необработанный Promise rejection:', reason);
});Такое часто случается, если забыть await или .catch().
async function save() {
throw new Error('DB error');
}
save(); // нет await и нет catchuncaughtException
setTimeout(() => {
throw new Error('Не поймано');
}, 0);
process.on('uncaughtException', (error) => {
console.error('Необработанное исключение:', error);
});Важный production-подход
Эти события не должны быть способом "продолжить как ни в чем не бывало". После необработанной ошибки состояние приложения может быть повреждено.
Обычно делают так:
- Логируют ошибку.
- Останавливают прием новых запросов.
- Закрывают соединения.
- Завершают процесс.
- Позволяют process manager перезапустить приложение.
Что важно помнить
- С Node.js 15 необработанное отклонение промиса по умолчанию завершает процесс.
- После
uncaughtExceptionсостояние процесса ненадежно: залогируйте ошибку и завершите процесс. - Перезапуск обеспечивает process manager или оркестратор (systemd, Docker, Kubernetes, PM2).
- Эти обработчики — последняя линия защиты, а не замена
try/catch.
Мини-шпаргалка
unhandledRejection- Promise-ошибка без обработки.uncaughtException- исключение безtry/catch.- Не используй их как обычную бизнес-логику.
- В production после таких ошибок часто нужен graceful shutdown.
- Лучше предотвращать их через
await,.catch()и централизованную обработку ошибок.
Документация
Node.js: Event 'uncaughtException', Node.js: Event 'unhandledRejection'.
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.