Jest测试TypeScript版AWS Lambda时,Mock服务相邻行变undefined
TypeScript AWS Lambda 单元测试异常记录
异常现象
- 针对业务服务配置Jest Mock后,服务初始化阶段状态正常,所有预期方法都能正常被识别
- 相邻两行代码的执行间隙,Mock实例突然变为undefined:上一行代码的console.log还能完整输出变量的定义与全部方法内容,下一行调用该实例方法时,直接抛出实例不存在的错误
- 调试过程的两个观测节点:
- 代码执行到
console.log("-> authenticationService", authenticationService)位置时,变量为已定义状态,所有挂载的方法完整可见 - 代码执行到下一行调用
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
相关产品推荐
相关产品推荐

