AWS Lambda出现间歇504（Endpoint request timed out）错误如何解决

该交替成功/失败的故障本质是Lambda执行环境复用机制导致的全局状态残留问题，首次冷启动时所有状态初始化正常所以请求成功，后续复用已有执行容器时，残留的全局对象/连接/配置冲突导致请求失败，失败后Lambda销毁异常容器，下一次请求触发新的冷启动又恢复正常，由此出现交替故障的现象。

排查与修复步骤 #

1. 优先检查FormData与Axios配置 #

这是multipart/form-data场景下最高发的问题：

• 禁止在handler函数外全局创建FormData实例，每次调用必须重新初始化，避免上一次请求的表单字段、边界值残留
• 不要手动写死multipart/form-data的boundary请求头，必须通过form.getHeaders()自动生成，避免和FormData内部实际使用的边界值不匹配
• Axios实例如果全局复用，必须配置正确的连接策略，默认的keep-alive机制在Lambda复用容器时可能出现异常断开的连接未被清理的问题

错误示例：

// 错误：全局创建FormData，多次调用会累加字段
const form = new FormData();
const axios = require('axios');

exports.handler = async (event) => {
  form.append('file', event.body);
  // 错误：手动写死boundary
  return axios.post('https://target-api.com/upload', form, {
    headers: {'Content-Type': 'multipart/form-data; boundary=----WebKitFormBoundaryxxx'}
  });
}

正确示例：

const axios = require('axios');
const http = require('http');
const https = require('https');
const FormData = require('form-data');

// Axios实例可全局复用，配置禁用keep-alive避免连接残留问题
const axiosInstance = axios.create({
  timeout: 10000,
  httpAgent: new http.Agent({ keepAlive: false }),
  httpsAgent: new https.Agent({ keepAlive: false })
});

exports.handler = async (event) => {
  // 每次调用新建FormData实例
  const form = new FormData();
  form.append('file', event.body);
  form.append('requestId', event.requestContext.requestId);

  return axiosInstance.post('https://target-api.com/upload', form, {
    // 自动生成匹配的form头，无需手动指定boundary
    headers: {
      ...form.getHeaders()
    }
  });
}

2. 检查数据库连接管理逻辑 #

如果请求失败时报错指向数据库操作，排查以下点：

• 全局复用的数据库连接必须开启自动重连配置，避免第一次调用创建的连接在容器空闲时被数据库服务端断开，第二次调用直接使用无效连接报错
• 数据库操作必须加异常捕获和重试逻辑，避免偶发的连接抖动导致整个请求失败
• 验证阶段可以临时改成每次调用新建数据库连接，如果故障消失即可确认是全局连接复用的问题

3. 补充日志定位具体故障点 #

如果以上调整后故障仍存在，在Lambda中补充全链路日志打印，每次调用时输出：

• Axios请求的完整请求头、响应状态、错误栈
• 数据库操作的执行耗时、错误信息
• Lambda执行上下文的awsRequestId，确认失败请求是否复用了之前的执行容器

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