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
相关产品推荐
相关产品推荐

