JavaScript中异步编程的异常处理有哪些方法

JavaScript异步编程异常处理的核心场景

JavaScript的异步编程主要经历了回调函数、Promise、async/await三个阶段，不同阶段的异步实现方式对应着不同的异常处理逻辑，理解这些差异才能正确捕获异步流程中的错误。异步异常和同步异常最大的区别在于，同步异常可以通过try-catch直接捕获，而异步操作的执行栈已经离开当前上下文，普通的try-catch无法直接捕获到异步回调中的错误。

回调函数模式的异常处理

早期JavaScript的异步操作大多基于回调函数实现，比如定时器、DOM事件、早期的Ajax请求等。这种模式下，通常遵循错误优先的约定，即回调函数的第一个参数用来接收错误信息，第二个参数才是正常的结果数据。

下面是一个基于回调的异步读取文件示例，模拟Node.js中fs模块的读取逻辑：

// 模拟异步读取文件的函数，遵循错误优先回调约定
function readFileCallback(path, callback) {
    setTimeout(() => {
        // 模拟读取失败的场景
        const err = new Error('文件不存在');
        const data = null;
        // 第一个参数传错误，第二个参数传结果
        callback(err, data);
    }, 1000);
}

// 调用异步函数，处理异常
readFileCallback('/test.txt', (err, data) => {
    if (err) {
        console.log('读取文件发生异常：', err.message);
        return;
    }
    console.log('读取到的文件内容：', data);
});

这种方式的缺点是如果异步操作嵌套层级过多，会出现回调地狱，异常处理逻辑也会分散在各个回调中，不利于维护。

Promise模式的异常处理

Promise是ES6引入的异步解决方案，它把异步操作的最终结果和对应的处理逻辑统一封装，提供了更清晰的异常处理方式。Promise的异常可以通过catch方法捕获，也可以在then方法的第二个参数中处理。

Promise内部的同步错误会被自动捕获并转为rejected状态，而Promise链中任何一个环节抛出错误，都会被后续的catch捕获。

// 返回Promise的异步函数
function readFilePromise(path) {
    return new Promise((resolve, reject) => {
        setTimeout(() => {
            // 模拟读取失败
            reject(new Error('文件读取失败'));
        }, 1000);
    });
}

// 方式1：使用then的第二个参数处理异常
readFilePromise('/test.txt')
    .then(
        (data) => {
            console.log('文件内容：', data);
        },
        (err) => {
            console.log('then第二个参数捕获异常：', err.message);
        }
    );

// 方式2：使用catch捕获异常，更推荐这种方式
readFilePromise('/test.txt')
    .then((data) => {
        console.log('文件内容：', data);
    })
    .catch((err) => {
        console.log('catch捕获异常：', err.message);
    });

需要注意的是，如果Promise链中已经用then的第二个参数处理了异常，后续的catch就不会再捕获到这个错误，因为异常已经被处理，Promise状态会转为fulfilled。

async/await模式的异常处理

async/await是ES2017引入的语法糖，基于Promise实现，让异步代码可以像同步代码一样书写。它的异常处理可以直接使用同步代码的try-catch结构，这是目前最推荐的异步异常处理方式。

await后面跟着的Promise如果被reject，就会被try-catch捕获到，不需要额外的链式调用。

// 基于前面的Promise函数
async function handleReadFile() {
    try {
        const data = await readFilePromise('/test.txt');
        console.log('文件内容：', data);
    } catch (err) {
        console.log('try-catch捕获异步异常：', err.message);
    } finally {
        console.log('无论成功失败都会执行的代码');
    }
}

handleReadFile();

如果async函数内部没有捕获异常，那么函数返回的Promise会变成rejected状态，可以在外部通过catch捕获：

async function unhandledAsyncFunc() {
    // 没有捕获异常，返回的Promise是rejected
    await readFilePromise('/test.txt');
}

unhandledAsyncFunc().catch((err) => {
    console.log('外部catch捕获async函数未处理的异常：', err.message);
});

全局异步异常捕获

除了针对单个异步操作的异常处理，还可以设置全局的异步异常捕获，用来兜底那些没有被显式处理的异步错误。

在浏览器环境中，可以监听unhandledrejection事件来捕获未处理的Promise异常：

window.addEventListener('unhandledrejection', (event) => {
    console.log('全局捕获未处理的Promise异常：', event.reason);
    // 可以阻止默认的控制台错误提示
    event.preventDefault();
});

在Node.js环境中，可以监听process的unhandledRejection事件：

process.on('unhandledRejection', (reason, promise) => {
    console.log('Node.js全局捕获未处理的Promise异常：', reason);
});

不同异常处理方式的对比

下面是三种常见异步异常处理方式的对比：

注意事项

• 不要在Promise的then方法里写空的catch，这样会吞掉错误，导致问题难以排查。
• async函数返回的Promise如果不需要处理，也要确保内部有异常捕获，否则可能触发全局未处理异常。
• 对于并行执行的多个异步操作，比如使用Promise.all，只要有一个Promise被reject，整个Promise.all就会reject，需要在外部捕获异常。

// Promise.all的异常处理示例
async function handleMultipleRequests() {
    try {
        const results = await Promise.all([
            readFilePromise('/file1.txt'),
            readFilePromise('/file2.txt')
        ]);
        console.log('所有请求完成：', results);
    } catch (err) {
        console.log('其中一个请求失败：', err.message);
    }
}

JavaScript异步编程异常处理Promiseasync_await修改时间：2026-07-11 12:51:43