Gatsby站点Netlify Functions Cookie格式异常问题咨询

这个问题并非浏览器发送请求不符合规范，而是Netlify边缘代理的头部处理逻辑叠加HTTP头部规范共同导致的：

• 首先Netlify全球分布式的边缘节点存在版本迭代不同步的问题，部分旧版本节点在转发请求到函数时，会错误地把本应是单个、用分号分隔多键值对的Cookie请求头，拆解为多个独立的同名字段。
• 按照HTTP RFC 7230的通用规则，代理层遇到重复的同名字段时，必须将其合并为单个字段，多个值之间用逗号加空格拼接。这就导致原本分号分隔的Cookie串，被拆分为多个字段后又通过逗号合并，最终你在函数内拿到的Cookie头就变成了逗号分隔的异常格式。

至于cookie.parse的解析异常，是因为这个库严格遵循Cookie请求头的官方解析规范，仅将分号识别为多个键值对的分隔符，遇到逗号分隔的串时，只会把第一个等号前的内容识别为键，后续所有内容（包括逗号、其他Cookie的键值对）都会被当成该键的对应值，和你观测到的解析结果完全一致。

小提示：你示例代码中打印的event.headers.cookies属于笔误，Netlify函数内的请求头键为全小写的cookie，如果打印带s的cookies字段会拿到空值。

兼容异常分隔符的手动解析 #

拿到原始Cookie头字符串后，先对异常的分隔符做定向修正，再传入cookie.parse解析。这里需要注意不要直接全局替换所有逗号，避免误伤Cookie值本身包含的逗号内容，建议用正则仅替换作为键值对分隔符的逗号：

import cookie from 'cookie'
export async function handler(event) {
  const rawCookie = event.headers.cookie || ''
  // 仅替换后面跟着合法Cookie键名的逗号，修正异常分隔符
  const fixedCookie = rawCookie.replace(/,\s*(?=[a-zA-Z0-9_\-]+=)/g, '; ')
  const parsedCookies = cookie.parse(fixedCookie)
  // 后续业务逻辑直接使用parsedCookies即可
}

使用Netlify内置的Cookie解析 #

Netlify函数的event对象本身自带了预解析完成的event.cookies字段，边缘层已经对这类分隔符异常的问题做了兼容处理，不需要你手动解析原始头部，直接调用即可拿到结构化的Cookie对象：

export async function handler(event) {
  // 直接使用内置解析好的Cookie，无需处理格式异常
  const parsedCookies = event.cookies
}

根因规避 #

你可以检查站点配置，这类异常更容易在开启了Netlify资源自动优化、或者通过重写规则将静态路径转发到函数的场景下触发。如果暂时不需要手动兼容，可以留意Netlify官方的版本同步进度，这个边缘头部合并的问题属于已知bug，后续会通过统一边缘节点版本完成修复。

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