AWS Lambda与API Gateway HTTP API多Set-Cookie header发送失败问题

要规范实现多Set-Cookie头的返回，核心是用Lambda响应里的multiValueHeaders字段，而非普通的headers字段，以下是具体实现和问题分析：

正确实现方式 #

HTTP API明确要求多值响应头通过multiValueHeaders传递，这里直接给出Node.js的Lambda示例：

exports.handler = async (event) => {
    return {
        statusCode: 200,
        multiValueHeaders: {
            'Set-Cookie': [
                'session-id=abc123; Path=/; HttpOnly; Secure',
                'theme=dark; Path=/; SameSite=Strict'
            ],
            'Content-Type': ['application/json']
        },
        body: JSON.stringify({ result: 'ok' })
    };
};

其他运行时（比如Python）同理，只要在响应结构里包含multiValueHeaders，并将Set-Cookie设为字符串数组即可。

为什么你之前的方法无效 #

• 普通headers字段重复键会被覆盖：当你在headers里多次设置Set-Cookie，HTTP API会自动保留最后一个值，这是头字段的默认处理逻辑；
• headers里放数组触发格式错误：HTTP API的headers字段只接受字符串值，传入数组会导致网关解析失败，返回500错误，但这个错误发生在网关层，所以Lambda日志不会记录；
• 文档里的cookie字段是请求处理用的：官方文档提到的cookie字段是用来解析请求中的Cookie，不是设置响应的Set-Cookie，所以对你的场景无效。

注意事项 #

• 每个Set-Cookie值要包含必要的属性（比如Path、HttpOnly、Secure、SameSite），符合浏览器的Cookie安全规范；
• 确保Lambda响应的结构正确，multiValueHeaders是顶层字段，和statusCode、body同级。

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