Node.js中Promise未处理的拒绝报错

在Node.js应用开发中，Promise未处理的拒绝（Unhandled Promise Rejection）是一个常见的错误。当Promise被拒绝（rejected）但没有相应的.catch()或try/catch块来处理这个拒绝时，Node.js会抛出未处理的拒绝错误。这些错误如果不加以处理，可能会导致应用崩溃或产生不可预期的行为。本文将结合CSDN社区的实战经验，系统性总结Node.js中Promise未处理的拒绝报错的常见原因及解决方案，并提供丰富的代码和表格示例分析。

---

一、Promise未处理的拒绝报错原因

1. 缺少.catch()处理

原因：在Promise链中，没有为.then()提供相应的.catch()处理拒绝。
示例：

const fetchData = () => {
    return new Promise((resolve, reject) => {
        reject(new Error('Failed to fetch data'));
    });
};

fetchData()
    .then(data => console.log(data)); // 缺少.catch()处理拒绝

2. 未捕获的async/await错误

原因：在使用async/await时，没有使用try/catch块来捕获错误。
示例：

const fetchDataAsync = async () => {
    const data = await fetchData(); // 如果fetchData()拒绝，没有try/catch处理
    console.log(data);
};

fetchDataAsync();

3. Promise构造函数中的同步错误

原因：在Promise构造函数中，同步抛出错误但未被捕获。
示例：

const fetchDataSync = () => {
    return new Promise((resolve, reject) => {
        throw new Error('Failed to fetch data'); // 同步抛出错误
    });
};

fetchDataSync()
    .then(data => console.log(data)); // 缺少.catch()处理拒绝

---

二、解决方案与代码示例

1. 使用.catch()处理拒绝

const fetchData = () => {
    return new Promise((resolve, reject) => {
        reject(new Error('Failed to fetch data'));
    });
};

fetchData()
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error.message)); // 使用.catch()处理拒绝

2. 使用try/catch处理async/await错误

const fetchDataAsync = async () => {
    try {
        const data = await fetchData();
        console.log(data);
    } catch (error) {
        console.error('Error:', error.message); // 使用try/catch捕获错误
    }
};

fetchDataAsync();

3. 使用unhandledRejection事件捕获未处理的拒绝

Node.js提供了unhandledRejection事件来捕获未处理的Promise拒绝。

process.on('unhandledRejection', (reason, promise) => {
    console.error('Unhandled Rejection at:', promise, 'reason:', reason);
    // 在这里可以记录日志或执行其他错误处理逻辑
});

const fetchData = () => {
    return new Promise((resolve, reject) => {
        reject(new Error('Failed to fetch data'));
    });
};

fetchData()
    .then(data => console.log(data)); // 即使没有.catch()，也能通过unhandledRejection事件捕获

4. 使用Promise.all()时的错误处理

const fetchData1 = () => Promise.resolve('Data 1');
const fetchData2 = () => Promise.reject(new Error('Failed to fetch data 2'));
const fetchData3 = () => Promise.resolve('Data 3');

Promise.all([fetchData1(), fetchData2(), fetchData3()])
    .then(results => console.log(results))
    .catch(error => console.error('Error:', error.message)); // 捕获Promise.all中的拒绝

---

三、常见问题与修复表

问题类型	示例	修复方案
缺少.catch()处理	fetchData().then(data => console.log(data));	添加.catch()处理拒绝
未捕获的async/await错误	const data = await fetchData();	使用try/catch块捕获错误
Promise构造函数中的同步错误	throw new Error('Failed to fetch data');	确保Promise构造函数中捕获同步错误

---

四、总结

1. 使用.catch()处理拒绝：在Promise链中始终添加.catch()处理拒绝。
2. 使用try/catch处理async/await错误：在使用async/await时，使用try/catch块来捕获错误。
3. 使用unhandledRejection事件：在Node.js中，使用unhandledRejection事件来捕获未处理的Promise拒绝。
4. 处理Promise.all()错误：在使用Promise.all()时，确保使用.catch()捕获可能的拒绝。

通过以上方法，可以有效避免Node.js中Promise未处理的拒绝报错，确保应用的稳定性和可靠性。