Node.js集成测试中Fire and Forget异步逻辑致Jest环境提前销毁如何解决

该问题的核心是测试仅等待了接口响应返回，并未等待sendStatus之后触发的后台异步任务additionalUpdate执行完成，Jest在测试用例断言通过后直接销毁运行上下文，导致仍在运行的异步任务访问已被回收的资源报错。

方案1：改造业务代码（推荐，不影响生产逻辑，同时修复线上隐患） #

原有控制器写法存在生产风险：additionalUpdate如果抛出异常会成为未捕获的Promise拒绝，可能触发线上进程崩溃，可以做兼容改造，仅在测试环境暴露后台任务状态：

// 仅测试环境导出的待执行后台任务队列
export const pendingBackgroundTasks = process.env.NODE_ENV === 'test' ? new Set<Promise<void>>() : null;

export const patchRecords = async (req: Request, res: Response) => {
    // 原有业务逻辑不变
    // Do some inserts.
    // Do some work.
    res.sendStatus(200);

    // 封装后台任务的异常处理
    const runBackgroundTask = async () => {
        try {
            await additionalUpdate();
        } catch (err) {
            // 生产环境补充异常日志记录逻辑，避免抛出未捕获错误
            console.error('additionalUpdate执行失败', err);
        } finally {
            // 测试环境下任务完成后从队列移除
            if (process.env.NODE_ENV === 'test' && pendingBackgroundTasks) {
                pendingBackgroundTasks.delete(taskPromise);
            }
        }
    };

    const taskPromise = runBackgroundTask();
    // 测试环境下将任务加入队列
    if (process.env.NODE_ENV === 'test' && pendingBackgroundTasks) {
        pendingBackgroundTasks.add(taskPromise);
    }
}

之后调整测试用例，在接口断言完成后等待所有后台任务执行完毕：

// 从控制器文件导入待执行任务队列
import { pendingBackgroundTasks } from '你的控制器文件路径';

it.only('should insert order for store and product.', async () => {
    const { status } = await jsonApiRequest(
        'POST',
        `${baseUrl}/updateproducts/${storeNumber}/${productId}`,
        {
            accessToken,
        }
    );
    expect(status).toBe(201);
    // 等待所有后台任务执行完成
    if (pendingBackgroundTasks) {
        await Promise.allSettled(pendingBackgroundTasks);
    }
});

该方案不会对生产环境造成任何额外性能开销，同时满足集成测试不Mock业务逻辑的要求，还修复了原有代码的线上异常风险。

方案2：临时调整Jest配置（无需修改业务代码，稳定性稍差） #

如果暂时不想修改业务代码，可以调整Jest配置，避免测试提前销毁上下文：
在jest.config.js中添加以下配置：

module.exports = {
    // 其他原有配置保持不变
    testTimeout: 30000, // 根据后台任务最大耗时调整全局测试超时时间，单位为毫秒
    detectOpenHandles: true, // 自动检测未完成的异步句柄
    forceExit: false, // 关闭强制退出，等待异步任务自然执行完成
}

该方案不需要修改业务逻辑，但如果后台任务耗时波动较大，可能仍会偶现超时问题，适合临时调试使用。

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