本文旨在帮助开发者理解和避免 Promise 异常处理中常见的错误。通过分析同步 throw 异常与 Promise 异步 rejected 之间的区别，阐述了在不同场景下正确捕获 Promise 异常的方法。同时，讨论了函数设计中统一错误处理方式的重要性，以提升代码的可维护性和可预测性。
理解同步异常与 Promise Rejected 的区别
在 JavaScript 中，同步 throw 异常和 Promise 的 rejected 状态是两种不同的错误处理机制。理解它们的区别是正确处理 Promise 异常的关键。
同步 throw 异常：
当在非 async 函数中直接使用 throw 语句抛出异常时，JavaScript 引擎会立即停止当前函数的执行，并沿着调用栈向上寻找 try...catch 块。如果找到匹配的 catch 块，则执行该块中的代码；否则，异常会继续向上抛出，直到程序崩溃。
Promise Rejected：
Promise 的 rejected 状态表示异步操作失败。当 Promise 被 rejected 时，会触发与该 Promise 关联的 .catch() 方法。如果 Promise 没有 .catch() 方法，则可能会导致未处理的 Promise rejected 错误。
Promise 异常捕获的正确姿势
Promise 机制会将 throw 抛出的错误转换为 rejected 的 Promise，但这只发生在特定的情况下：
-
new Promise 构造函数中： 在 new Promise((resolve, reject) => { ... }) 的 executor 函数中抛出的任何错误都会导致 Promise 被 rejected。
new Promise((resolve, reject) => { throw new Error('Error in Promise constructor'); }).catch(error => { console.log('Caught error:', error.message); // 输出: Caught error: Error in Promise constructor }); -
Promise.then() 或 Promise.catch() 的回调函数中： 在 .then() 或 .catch() 方法的回调函数中抛出的任何错误都会导致后续的 Promise 被 rejected。
Promise.resolve() .then(() => { throw new Error('Error in .then()'); }) .catch(error => { console.log('Caught error:', error.message); // 输出: Caught error: Error in .then() }); -
async 函数中： 在 async 函数中抛出的任何错误都会导致该函数返回的 Promise 被 rejected。
async function myAsyncFunction() { throw new Error('Error in async function'); } myAsyncFunction() .catch(error => { console.log('Caught error:', error.message); // 输出: Caught error: Error in async function });
问题代码分析及修复：
在原始问题中，DeleteProject 函数被定义为返回 Promise<void>，但它并没有被标记为 async 函数。这意味着 throw new Error('test error'); 抛出的异常不会被 Promise 机制自动捕获，而是作为同步异常抛出。
要解决这个问题，有两种方法：
方法一：将函数声明为 async 函数。
async DeleteProject(id: string, customerId: string): Promise<void> {
throw new Error('test error');
}通过将 DeleteProject 函数声明为 async 函数，throw 语句抛出的异常会被自动转换为 rejected 的 Promise，从而被 .catch() 方法捕获。
方法二：使用 Promise.reject() 返回 rejected 的 Promise。
DeleteProject(id: string, customerId: string): Promise<void> {
return Promise.reject(new Error('test error'));
}使用 Promise.reject() 可以显式地返回一个 rejected 的 Promise，从而确保异常能够被 .catch() 方法捕获。
统一错误处理：提升代码可维护性
在函数设计中，最好采用统一的错误处理方式，以提升代码的可维护性和可预测性。
建议使用 Promise.reject() 返回 rejected 的 Promise，而不是直接使用 throw 语句抛出异常。这样做的好处是：
- 统一错误处理方式： 无论错误是同步还是异步发生的，都通过 Promise 的 rejected 状态来传递错误信息。
- 避免遗漏异常： 确保所有错误都能被 .catch() 方法捕获，避免未处理的异常导致程序崩溃。
- 代码可读性更强： 显式地使用 Promise.reject() 可以更清晰地表达函数可能返回错误的状态。
即使在某些情况下可以同步检测到错误，也建议将错误包装成 rejected 的 Promise 返回。例如：
function validateInput(input: any): Promise<void> {
if (typeof input !== 'string') {
return Promise.reject(new Error('Invalid input type'));
}
// ... 其他验证逻辑
return Promise.resolve();
}结论
理解 Promise 异常处理机制，区分同步异常和 Promise rejected 的不同，并采用统一的错误处理方式，可以帮助开发者编写更健壮、更易于维护的 JavaScript 代码。始终确保 Promise 链中有 .catch() 方法来捕获可能发生的异常，避免未处理的 Promise rejected 错误。
