Lambda函数URL请求报错：POST接口返回502内部服务器错误

1. 校验Lambda响应格式是否合规 #

Lambda函数URL对响应格式有强制要求：必须包含statusCode、headers（至少要指定Content-Type）和body字段，且body需为JSON字符串（返回JSON数据时）。本地调用可能不会严格校验格式，但函数URL会直接因格式不符返回502。

• 错误示例：直接返回业务对象

  return { "data": "test result" };
  

• 正确示例：

  return {
    statusCode: 200,
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ "data": "test result" })
  };
  

2. 排查权限差异问题 #

本地调用依赖的是开发者本地环境权限，部署后的Lambda函数则使用配置的IAM角色权限，若角色缺少资源访问权限（如访问DynamoDB、S3），会导致函数执行失败但本地测试无异常。

• 查看CloudWatch日志：进入AWS控制台的Lambda函数详情页，在Monitor标签下查看CloudWatch日志，排查是否存在AccessDenied类权限错误。
• 检查serverless.yml中的IAM角色配置，确保函数所需的所有资源权限都已声明。

3. 验证POST请求参数格式 #

本地测试可能用预设参数，实际请求的参数格式可能不符合函数预期（如未设置Content-Type: application/json、请求体不是合法JSON），导致函数执行出错，返回不符合要求的响应触发502。

• 用curl或Postman测试时，明确指定请求头和合法JSON体：

  curl -X POST https://<你的Lambda函数URL> \
    -H "Content-Type: application/json" \
    -d '{"param": "value"}'
  

4. 捕获未处理的异常 #

本地测试可能未覆盖全部分支逻辑，部署后函数触发未捕获的异常时，会返回无效响应格式，进而触发502。需在代码中添加全局异常捕获：

exports.handler = async (event) => {
  try {
    // 业务逻辑代码
    return {
      statusCode: 200,
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ success: true })
    };
  } catch (error) {
    console.error("执行出错:", error);
    return {
      statusCode: 500,
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ error: "服务内部错误" })
    };
  }
};

5. 检查函数URL配置 #

• 认证类型：若函数URL设置为AWS_IAM，需确保请求携带有效的IAM签名；若为NONE，则需确认请求无需认证即可访问。
• CORS配置：若请求来自浏览器，需确保函数URL的CORS规则允许对应的请求Origin、Methods和Headers。

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