AWS Lambda getRemainingTimeInMillis()返回负值的原因排查

问题背景 #

我创建了一个设置15分钟（900000毫秒）超时的Lambda函数，超时后会重新调用自身。但首次执行时，调用context.getRemainingTimeInMillis()返回了负值，相关代码如下：

if (context) {

    // getRemainingTimeInMillis() that is returning negative value
    const contextRemainingTime = context.getRemainingTimeInMillis();
    const timeoutError = new Error('promise timed out');
    const lambdaTimeoutInMs = 900000;

    await timeoutHandler(
        syncInvoiceAccessesProductUpdate({ product, actor }),

        // Condition so that when there are 10 seconds left of the timeout, the lambda function must be executed again
        (contextRemainingTime > lambdaTimeoutInMs ? lambdaTimeoutInMs : contextRemainingTime) - 10000,

        timeoutError,
    ).catch(async (error) => {
        
        if (error !== timeoutError) {
            throw error;
        }

        new AppError({
            message: 'timetout handler test at sync invoice accesses product update job',
            payload: { contextRemainingTime, lambdaTimeoutInMs },
            code: ERROR_CODE.ACCESS_DENIED,
        });

        const agendaClient = await getAgendaClient();
        await agendaClient.now(JOB_NAME, {
            productId,
            actor,
        });
    });
}

日志也显示该方法返回了负值，请问这一现象的原因是什么？

可能的原因分析 #

• 冷启动阶段耗时超配置超时：Lambda首次执行的冷启动会包含环境初始化、代码包加载、依赖安装等操作，这些时间全部计入函数总超时时长。如果初始化耗时超过了你配置的15分钟，getRemainingTimeInMillis()就会返回负值——相当于已用时间已经超过了预设的总超时。
• 调用时机错误：如果这段代码是在Lambda的handler函数体外的初始化逻辑中调用的，此时函数的执行计时器还未正确初始化，就可能返回异常的负值。要确保getRemainingTimeInMillis()是在处理请求的handler函数内部调用的。
• 配置超时与代码硬编码值不匹配：如果AWS控制台中实际配置的Lambda超时小于15分钟（比如误设成更短时间），但代码里硬写了lambdaTimeoutInMs = 900000，当剩余时间计算时会出现逻辑偏差，甚至导致负值。比如实际超时设为5分钟，但初始化用了6分钟，剩余时间自然为负。
• 自定义超时工具类干扰：你的timeoutHandler如果内部有修改剩余时间的逻辑，可能间接导致contextRemainingTime异常。可以先在handler里直接打印context.getRemainingTimeInMillis()的结果，排除自定义工具类的影响。

内容的提问来源于stack exchange，提问作者Vinícius Mendes de Souza