如何在AWS Lambda(Node.js)的REST API中处理非法查询参数并返回400/404

问题描述 #

我的REST API端点为/resource?param1=abc，当有人传入额外非法参数（如/resource?param1=abc&illegalParam=xyz）时，希望返回HTTP 400或404错误，需要知道如何读取所有传入的查询参数并实现校验逻辑，应用基于AWS Lambda（Node.js）开发。

实现步骤 #

1. 从Lambda事件中获取查询参数 #

在AWS Lambda的Node.js环境中，请求的查询参数会被封装在事件对象的queryStringParameters字段中（适配API Gateway的HTTP/REST API集成场景）。直接从该字段即可获取所有传入参数：

exports.handler = async (event) => {
  // 若没有查询参数则返回空对象，避免后续报错
  const incomingParams = event.queryStringParameters || {};
  // 后续校验逻辑
};

2. 定义合法参数白名单 #

先明确API允许接收的参数列表，比如当前场景仅允许param1：

const allowedParams = ['param1'];

3. 校验并拦截非法参数 #

遍历传入参数的键名，对比白名单找出非法参数，存在则直接返回错误响应：

// 获取所有传入参数的键名集合
const incomingParamKeys = Object.keys(incomingParams);
// 筛选出不在白名单中的参数
const illegalParams = incomingParamKeys.filter(key => !allowedParams.includes(key));

if (illegalParams.length > 0) {
  // 返回400错误（参数非法的标准状态码，比404更贴合场景）
  return {
    statusCode: 400,
    body: JSON.stringify({
      error: '存在非法查询参数',
      invalidParams: illegalParams
    }),
    headers: {
      'Content-Type': 'application/json'
    }
  };
}

4. 处理合法请求 #

参数校验通过后，执行正常业务逻辑并返回成功响应：

// 提取合法参数值
const param1Value = incomingParams.param1;
// 此处编写你的业务代码，比如查询数据库、处理数据等

return {
  statusCode: 200,
  body: JSON.stringify({
    message: '请求处理成功',
    data: { param1: param1Value }
  }),
  headers: {
    'Content-Type': 'application/json'
  }
};

内容的提问来源于stack exchange，提问作者Rajarshi Ghoshal