如何在Express中间件中调用异步函数？Express 5.x问题排查

问题场景 #

• 环境：Express 5.0.0-beta.1
• 需求：编写JWT认证中间件，从Authorization请求头提取token，调用返回Promise的validateToken函数完成验证；token不存在或格式错误时返回401，验证失败返回403，验证通过则放行请求
• 异常表现：不带token的请求能正常返回401，但带token的请求会无限挂起，即便Express 5支持自动处理中间件返回的Promise，问题仍存在

问题根源分析 #

1. 正则匹配未做空值判断：regex.exec(token)[1]如果token不符合Bearer 开头的格式，exec会返回null，直接访问[1]会抛出未捕获的同步错误，导致Promise链中断，Express无法处理该错误
2. validateToken未正确决议Promise：代码中未提供validateToken的实现，如果该函数的Promise一直处于pending状态（未调用resolve或reject），会直接导致请求挂起
3. Promise链的错误覆盖问题：原代码中catch分支直接传递新的HttpError，但如果validateToken抛出的错误未被正确捕获，或者next()的调用逻辑存在异常，也会导致请求无响应

修复方案 #

1. 修复正则匹配的错误处理 #

先判断正则匹配结果是否存在，避免抛出同步错误：

const regex = /^Bearer (.+)$/;
const match = regex.exec(token);
if (!match) {
    console.info("Malformed JWT");
    return next(new HttpError(401, 'Unauthorized'));
}
const jwt = match[1];

2. 确保validateToken正确决议Promise #

必须保证validateToken最终会进入resolve或reject状态，示例实现如下（可根据实际业务逻辑替换）：

// 示例token验证函数
function validateToken({ jwt, path }) {
    return new Promise((resolve, reject) => {
        // 模拟验证逻辑，比如调用JWT库解析验证
        if (jwt === 'valid-demo-token') {
            resolve({ status: 'valid', userId: 123 });
        } else {
            reject(new Error('Token verification failed'));
        }
    });
}

3. 改用async/await简化异步逻辑（推荐） #

Express 5支持async中间件，能自动捕获Promise的错误，代码更简洁易维护：

const authMiddleware = async (req, res, next) => {
    const token = req.header('Authorization');
    if (!token) {
        console.info("No JWT in request");
        return next(new HttpError(401, 'Unauthorized'));
    }

    const regex = /^Bearer (.+)$/;
    const match = regex.exec(token);
    if (!match) {
        console.info("Malformed JWT");
        return next(new HttpError(401, 'Unauthorized'));
    }
    const jwt = match[1];

    try {
        await validateToken({ jwt, path: '/secured' });
        next(); // 验证通过，放行至下一个中间件/路由
    } catch (err) {
        next(new HttpError(403, 'Forbidden')); // 验证失败，传递错误至错误中间件
    }
};

4. 增强全局错误捕获（可选） #

为避免未捕获的同步/异步错误导致请求挂起，可在所有路由和中间件之后添加兜底错误处理：

app.use((err, req, res, next) => {
    console.error('Uncaught server error:', err);
    const statusCode = err.status || 500;
    res.status(statusCode).json({ 
        message: statusCode === 500 ? 'Internal Server Error' : err.message 
    });
});

总结 #

• 核心问题是未处理正则匹配的同步错误和**validateToken的Promise未正确决议**
• Express 5的Promise自动处理仅针对中间件返回的Promise，同步错误仍需手动捕获，使用async/await可让Express自动捕获所有异步和同步错误
• 规范的Promise决议和错误捕获逻辑，是避免异步中间件挂起的关键

内容的提问来源于stack exchange，提问作者Daniel Kesner