You need to enable JavaScript to run this app. Netlify Serverless函数解析event对象时JSON.parse()报错
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 04:15:03