You need to enable JavaScript to run this app. Jest测试TypeScript版AWS Lambda时,Mock服务相邻行变undefined
优惠活动
大模型
产品
解决方案
定价
更多

Jest测试TypeScript版AWS Lambda时,Mock服务相邻行变undefined

TypeScript AWS Lambda 单元测试异常记录

异常现象

  • 针对业务服务配置Jest Mock后,服务初始化阶段状态正常,所有预期方法都能正常被识别
  • 相邻两行代码的执行间隙,Mock实例突然变为undefined:上一行代码的console.log还能完整输出变量的定义与全部方法内容,下一行调用该实例方法时,直接抛出实例不存在的错误
  • 调试过程的两个观测节点:
    1. 代码执行到console.log("-> authenticationService", authenticationService)位置时,变量为已定义状态,所有挂载的方法完整可见
    2. 代码执行到下一行调用authenticationService.changePassword()逻辑时,调试器显示该实例值为undefined

相关代码片段

Lambda 业务实现代码

export const changePassword = LambdaUtils.wrapApiHandler(
async (event: LambdaUtils.APIGatewayProxyEvent, context: Context) => {
    const accessToken = event?.body?.accessToken;
    const previousPassword = event?.body?.previousPassword;
    const proposedPassword = event?.body?.proposedPassword;

    // 依赖注入方式获取服务的尝试:因为DI机制的存在,获取到的服务始终为undefined
    // let authenticationService = Injector.getByName("AuthenticationService"); 

    // 直接初始化服务的方式:初始化阶段能拿到完整的Mock实例
    const authenticationService = new AuthenticationService(); 
    console.log("-> authenticationService", authenticationService); 
    
    // 调用方法时触发实例为undefined的错误
    const response = await authenticationService.changePassword( 
        accessToken,
        previousPassword,
        proposedPassword
    ); 

    console.log("response in auth_handler", response);

    if (response?.statusCode === 200) {
        return new LambdaUtilities().createHttp200Response(response);
    } 
}
);

测试用例代码

jest.mock("../../../controllers/auth.service");
const MockedAuthService = AuthenticationService as jest.Mock<AuthenticationService>;

test(`Test successful response of changePassword Repo function"`, async () => {
    const accessToken = "accessToken";
    const previousPassword = "123456";
    const proposedPassword = "654321";

    // 测试用例内手动初始化的Mock实例
    const mockAuthService = new MockedAuthService() as jest.Mocked<AuthenticationService>;
    console.log("-> mockAuthService", mockAuthService);

    const event = {
        body: {
            accessToken,
            proposedPassword,
            previousPassword
        }
    };
    const response = await changePassword(event, {}, {});

    console.log("response", response);
    expect(response).not.toBeNull();
});

触发原因

  • Jest对类做自动Mock时,不会主动指定构造函数的返回值,生成的实例是带Proxy的代理对象;当代码进入async函数的微任务执行阶段时,V8会对作用域内的临时引用做优化回收,触发调试器的读值偏差,甚至出现方法绑定失效的问题,抛出的报错会被调试器误判为实例本身是undefined
  • 测试用例内手动初始化的mockAuthService实例,和Lambda函数内部通过new生成的Mock实例是两个完全独立的对象,没有打通方法的返回值桩配置,直接导致调用逻辑异常
  • Jest运行时的console.log输出存在异步缓存机制,看到的正常输出是代码执行前的状态快照,不是实际调用方法时的实时值

落地的修复思路

  • 不依赖自动Mock的默认构造函数行为,手动给类Mock指定固定的构造函数返回值,确保所有通过new生成的实例,都共享同一个预配置了测试桩的对象
  • 优化依赖注入逻辑,把Mock实例直接传入Lambda函数的执行上下文,避免在业务逻辑内部手动实例化服务,从根源上减少独立Mock对象的生成
  • 调试过程中不通过console.log的输出判断变量状态,在方法调用位置打原生断点,直接读取实时的作用域变量值,排查真实的报错来源

内容的提问来源于stack exchange,提问作者Benjamin Heinke

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 08:15:08