Serverless HttpApi自定义响应参数映射问题：无法添加自定义响应头

你遇到的问题确实存在：Serverless Framework的response.statusCodes配置仅适用于传统的http事件（对应AWS API Gateway v1），并不支持httpApi事件（对应API Gateway v2），所以你的配置不会生效。

你的配置代码如下：

functions:
  myfunction:
    name: test
    handler: src/index.handler
    events:
      - httpApi:
          path: /graphql
          method: post
          response:
            statusCodes:
              200:
                headers:
                  Strict-Transport-Security: "'max-age=31536000'"
              500:
                headers:
                  Strict-Transport-Security: "'max-age=31536000'"

解决方案 #

1. 在Lambda处理函数中手动设置响应头

这是最直接且灵活的方式，在业务代码返回响应时直接添加自定义头。以Node.js为例：

exports.handler = async (event) => {
  try {
    // 执行业务逻辑
    const result = await yourBusinessLogic(event);
    
    return {
      statusCode: 200,
      headers: {
        'Strict-Transport-Security': 'max-age=31536000',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(result)
    };
  } catch (error) {
    return {
      statusCode: 500,
      headers: {
        'Strict-Transport-Security': 'max-age=31536000',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ error: error.message })
    };
  }
};

这种方式可以针对不同响应状态码精准设置对应头信息。

2. 配置HTTP API全局响应头

如果需要给整个HTTP API的所有端点添加统一响应头，可通过Serverless Framework的httpApi全局配置实现：

service: your-service-name
provider:
  name: aws
  runtime: nodejs18.x

httpApi:
  cors:
    allowedOrigins: ['*']
    allowedMethods: ['POST']
    allowedHeaders: ['Content-Type']
    exposedHeaders: ['Strict-Transport-Security']
  # 全局默认响应头配置
  defaultRouteSettings:
    responseParameters:
      headers:
        Strict-Transport-Security: "'max-age=31536000'"

functions:
  myfunction:
    name: test
    handler: src/index.handler
    events:
      - httpApi:
          path: /graphql
          method: post

注意：全局配置会应用到该HTTP API下的所有路由，适合需要统一添加头信息的场景。

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