You need to enable JavaScript to run this app. Fastify配置请求校验Schema后,POST提交JSON仍提示body应为对象
优惠活动
大模型
产品
解决方案
定价
更多

Fastify配置请求校验Schema后,POST提交JSON仍提示body应为对象

问题根因

Fastify没有将本次POST请求体按JSON格式自动解析,最终获取到的请求体是原始字符串,不符合Schema要求的对象类型,因此触发body should be object校验错误,也才需要在控制器中手动执行JSON.parse()。

最常见诱因:前端缺失Content-Type: application/json请求头

原生fetch不会因为传入了JSON.stringify的body就自动设置JSON格式的Content-Type,默认会将其设为text/plain;charset=UTF-8。Fastify内置的JSON解析器仅会自动处理Content-Type为application/json的请求,其余类型的请求体只会以原始字符串形式挂载到req.body上。

前端修复方案

给fetch请求添加对应请求头即可:

const response = await fetch(process.env.REACT_APP_API_HOSTNAME + '/api/reservations/' + property.slug, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(requestBody)
});

已加头仍报错的排查方向

如果已经添加上述请求头仍有问题,按以下顺序排查:

  • 跨域配置校验:如果前后端分属不同域名,Content-Type: application/json属于非简单请求头,会触发CORS预检。如果后端CORS配置未允许该头跨域传递,浏览器会自动剥离该头,后端实际收到的Content-Type仍不符合要求。使用@fastify/cors插件时需在配置中显式声明允许该头跨域。
  • 请求流消费校验:如果在全局钩子、路由preHandler钩子中手动读取、pipe过req流,Fastify会因为请求流已被消费无法自动解析body。
  • 中间件冲突校验:如果手动接入了Express生态的body解析中间件(如body-parser),需确认中间件执行顺序是否合理,避免和Fastify内置解析逻辑冲突。
  • Fastify版本校验:极旧版本(v2及以下)的Fastify无内置JSON解析能力,需手动注册对应生态的JSON body解析插件。
    修复完成后,Fastify会自动将请求体解析为对象,无需在控制器中手动执行JSON.parse()。

内容的提问来源于stack exchange,提问作者Mike

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.27 08:36:03