Node Typescript接口请求无法设置Cookie问题求助

你使用的js-cookie、cookie-js均为前端浏览器环境专用的Cookie操作工具，依赖浏览器的document.cookieAPI实现功能。而AWS Lambda是服务端运行环境，不存在浏览器上下文，调用这类包的set方法不会产生任何效果，自然也无法生成Set-Cookie响应头返回给客户端。

1. 替换依赖包 #

服务端生成Cookie请使用Node生态专用的cookie包，用于序列化符合规范的Set-Cookie字段值：

npm install cookie

2. 调整Lambda返回逻辑 #

AWS Lambda配合API Gateway返回响应时，需要主动将生成的Cookie配置到响应头中，示例代码如下：

import * as cookie from 'cookie';
import { APIGatewayEvent, Context, APIGatewayProxyResult } from 'aws-lambda';

export const init = async (event: APIGatewayEvent, context: Context): Promise<APIGatewayProxyResult> => {
  // 序列化Cookie，可根据需求配置属性
  const setCookieValue = cookie.serialize('hello', 'hello', {
    path: '/',
    secure: process.env.NODE_ENV === 'production', // 生产环境HTTPS下必须设为true
    httpOnly: true, // 禁止前端JS读取，提升安全性
    sameSite: 'none', // 跨域场景需要设为none，同时secure必须为true
    maxAge: 24 * 60 * 60 // 有效期1天
  });

  // 返回响应时主动带上Set-Cookie头
  return {
    statusCode: 200,
    headers: {
      'Content-Type': 'application/json',
      'Set-Cookie': setCookieValue,
      // 跨域场景需要额外配置CORS头
      'Access-Control-Allow-Origin': '你的前端域名',
      'Access-Control-Allow-Credentials': 'true'
    },
    // 如果需要同时设置多个Cookie，使用multiValueHeaders字段
    // multiValueHeaders: {
    //   'Set-Cookie': [setCookieValue1, setCookieValue2]
    // },
    body: JSON.stringify({ code: 0, msg: 'success' })
  }
}

3. 调整前端fetch请求配置 #

跨域请求场景下，需要给fetch加上credentials: 'include'配置，浏览器才会接受并保存接口返回的Cookie：

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow',
  credentials: 'include' // 新增该行配置
};

• 若使用API Gateway HTTP API类型，返回多Cookie时需使用响应结构顶层的cookies字段传递Cookie数组
• 生产环境下Cookie的secure属性必须设为true，sameSite设为none时也要求secure为true
• 跨域配置中Access-Control-Allow-Origin不能设为*，必须指定具体的前端域名，否则带凭证的请求会被浏览器拦截

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