使用Serverless本地运行AWS Lambda时，查询参数传递后Postman返回异常

核心问题分析 #

你的Lambda能正常查询本地DynamoDB并输出结果，但返回的响应不符合Serverless Offline模拟的API Gateway规范，或者重定向URL的路径与本地服务路由不匹配，最终导致404错误。

步骤1：修正Lambda响应格式 #

API Gateway（包括serverless-offline）要求重定向响应必须满足规范结构，否则无法正确触发重定向逻辑：

• 必须返回3xx类状态码（常用302临时重定向）
• Location头要放在headers字段下
• 响应需包含statusCode、headers等必填结构

错误示例（可能的原有写法）：

// 不符合API Gateway规范的响应
return {
  Location: fetchResult.url
};

正确响应写法：

exports.handler = async (event) => {
  // 你的DynamoDB查询逻辑
  const fetchResult = await queryDynamoDB(event.queryStringParameters.id);
  
  // 符合规范的重定向响应
  return {
    statusCode: 302,
    headers: {
      'Location': fetchResult.url,
      'Access-Control-Allow-Origin': '*' // 跨域场景必须添加，避免浏览器拦截
    },
    body: '' // 重定向场景可留空body
  };
};

步骤2：检查Serverless.yaml路由配置 #

确保函数的HTTP事件配置正确，且重定向目标URL在本地服务中可访问：

1. 确认函数的路径、方法配置无误：

functions:
  redirectHandler:
    handler: handler.redirect
    events:
      - http:
          path: redirect # 或带路径参数的格式，比如 /redirect/{id}
          method: get
          cors: true # 跨域场景开启该配置

2. 如果重定向目标是本地服务内的路径，需确保该路径已在serverless.yaml中配置对应的Lambda函数或静态资源路由。

步骤3：验证重定向URL有效性 #

• 若重定向外部URL，必须是完整的绝对路径（包含http:///https://），避免浏览器解析为相对路径导致404
• 若重定向本地路径，建议使用完整绝对URL（比如http://localhost:3000/target-path），而非相对路径/target-path（本地环境可能存在解析异常）

步骤4：Serverless Offline本地调试注意事项 #

• 修改代码或配置后，重启serverless-offline服务：serverless offline start，确保变更生效
• Postman测试时，关闭「Automatically follow redirects」选项，可直接查看302状态码和Location头，确认返回是否正确
• 浏览器测试时，打开开发者工具Network面板，查看重定向请求的目标URL和状态码，排查路径是否匹配

内容的提问来源于stack exchange，提问作者Muhammad Ahsan