Lambda@Edge(Node.js)返回502错误：Headers对象格式不符排查

Lambda@Edge对响应Headers的格式有强制要求：每个Header的取值必须是数组类型，哪怕该Header只有一个值。而Express框架默认生成的响应Header是字符串类型，serverless-http在本地测试时会兼容这种格式，但部署到Lambda@Edge后，CloudFront会严格校验Headers格式，一旦发现非数组类型的Header值（比如content-type是字符串），就会抛出Validation error并返回502错误。

解决方法 #

1. 自定义serverless-http的响应转换逻辑 #

通过serverless-http的配置选项，手动将Express响应的Headers转换为Lambda@Edge要求的数组格式：

const serverless = require('serverless-http');
const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Hello from Lambda@Edge!');
});

const handler = serverless(app, {
  response: (req, res) => {
    const lambdaResp = {
      statusCode: res.statusCode,
      headers: {},
      body: res.body,
      isBase64Encoded: false
    };

    // 遍历所有响应Header，转成数组格式
    Object.entries(res.getHeaders()).forEach(([key, val]) => {
      lambdaResp.headers[key] = Array.isArray(val) ? val : [val];
    });

    return lambdaResp;
  }
});

module.exports.handler = handler;

2. 使用Express中间件统一处理Header格式 #

添加一个全局中间件，重写res.setHeader方法，自动将所有Header值包装为数组：

const express = require('express');
const serverless = require('serverless-http');
const app = express();

// 统一处理Header格式的中间件
app.use((req, res, next) => {
  const originalSetHeader = res.setHeader;
  res.setHeader = function(key, value) {
    const formattedValue = Array.isArray(value) ? value : [value];
    return originalSetHeader.call(this, key, formattedValue);
  };
  next();
});

app.get('/', (req, res) => {
  res.send('Hello World');
});

module.exports.handler = serverless(app);

3. 手动设置Header时直接使用数组 #

如果是自己手动设置的Header，直接传入数组类型的值，跳过自动转换：

app.get('/', (req, res) => {
  // 直接用数组格式设置Content-Type
  res.setHeader('content-type', ['text/html; charset=utf-8']);
  res.send('Hello from Lambda@Edge!');
});

验证要点 #

• 部署完成后，查看CloudWatch边缘函数日志，确认不再出现Headers格式相关的Validation error
• 注意：Lambda@Edge的Header格式是为了支持HTTP多值Header，因此所有Header值都必须是数组，哪怕只有一个取值

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