Netlify Serverless函数解析event对象时JSON.parse()报错
问题根因定位
报错Unexpected token a in JSON at position 1是因为在代码第5行直接调用JSON.parse(event.body)时,传入的字符串不是合法JSON格式,和Netlify文档的通用说明不存在冲突——文档明确说明仅当请求头携带Content-Type: application/json时,event.body才是可直接解析的JSON格式字符串,其他请求场景下event.body是原始的未处理文本。
从报错特征“position 1 位置出现字符a”判断,该问题大概率属于以下常见触发场景:
- 前端提交表单时未设置正确的请求头:直接将FormData、普通文本通过fetch/axios发送,没有指定
Content-Type: application/json,此时Netlify传入的event.body是key=value&key2=value2格式的urlencoded查询串;如果请求体开头是=action=submit...结构,位置0为分隔符、位置1是参数开头的a,就会精准匹配当前的报错信息 - 提交请求使用了
multipart/form-data格式:此时event.body是带边界分隔符的二进制文本流,包含表单域拆分标记,根本不符合JSON语法规范 - 前端发送请求时重复对JSON做了字符串化处理,导致传入的字符串前后带多余引号、转义字符,破坏了原有JSON结构
可落地的修复方案
- 替换原有的硬解析逻辑,增加兼容处理,覆盖不同Content-Type的请求场景:
let payload = {} if (event.body) { // 兼容base64编码的二进制请求体,先解码为utf8字符串 const rawBody = event.isBase64Encoded ? Buffer.from(event.body, 'base64').toString('utf8') : event.body // 优先尝试JSON解析 try { payload = JSON.parse(rawBody) } catch (parseErr) { // JSON解析失败时,自动按照urlencoded格式解析参数 const searchParams = new URLSearchParams(rawBody) searchParams.forEach((value, key) => { payload[key] = value }) } } - 前端提交表单时调整请求构造逻辑:手动把表单数据转为JSON字符串,显式指定
Content-Type: application/json头,不要直接把FormData实例当请求体发送。合法的提交写法参考:const formEl = document.querySelector('form') formEl.addEventListener('submit', async (e) => { e.preventDefault() const formData = new FormData(formEl) // 把FormData转为普通对象,再序列化为JSON字符串 const payload = Object.fromEntries(formData.entries()) await fetch('/.netlify/functions/sendmail', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }) }) - 临时调试可在解析前打印原始
event.body和event.headers['content-type'],直观确认实际传入的内容格式——如果打印结果显示event.body是类contact=submit&name=xxx&email=xxx的结构,即可实锤是Content-Type不匹配导致的解析失败。
注意:Netlify Serverless函数不会自动解析非JSON格式的请求体,所有非
application/json的内容都会以原始字符串形式挂载在event.body上,必须自行做格式兼容处理。
内容的提问来源于stack exchange,提问作者Robert Jamborski
相关产品推荐
相关产品推荐

