如何避免Serverless框架下Lambda返回API Gateway的Header被重映射？

嘿，我之前也踩过这个坑！AWS Lambda搭配API Gateway的时候，WWW-Authenticate这类标准认证头会被自动重命名成x-amzn-Remapped-WWW-Authenticate，要让它原样返回，得从API Gateway的配置入手，分两种常用场景给你说：

场景1：使用REST API（旧版API Gateway） #

这种情况需要显式在API Gateway里声明并映射这个响应头：

1. 打开API Gateway控制台，找到你的目标API，进入对应的资源和方法（比如你返回401的那个接口）。
2. 切换到方法响应标签页，找到HTTP状态码401的配置项，点击「添加响应头」，输入WWW-Authenticate并保存。
3. 再切换到集成响应标签页，同样找到401状态码，在「头映射」区域添加一条映射：
   • 响应头名称填WWW-Authenticate
   • 映射值填integration.response.header.WWW-Authenticate
4. 最重要的一步：回到API的「部署」页面，重新部署到你的阶段（比如prod），不然配置不会生效。

场景2：使用HTTP API（新版API Gateway） #

新版HTTP API的配置更简洁：

1. 进入HTTP API的控制台，找到「CORS」配置项。
2. 在「暴露的头（Exposed Headers）」列表里添加WWW-Authenticate，保存配置。
3. 如果还是不行，检查「集成」配置里有没有自定义的头重映射规则，删掉针对WWW-Authenticate的重映射即可。

额外提示：如果用Lambda函数URL #

如果你是直接用Lambda函数URL（没有经过API Gateway），那根本不需要额外配置——直接返回你写的响应头就能原样输出，不会被重映射。如果这种情况还出问题，检查下你的响应头格式有没有错误，比如引号是否正确转义（你当前写的'WWW-Authenticate': 'Basic realm="My realm"'是没问题的）。

配置完后，用curl -v https://your-api-endpoint测试一下，就能看到WWW-Authenticate头正常出现在响应里了。

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