应通过c.Request().Header.Get("Content-Type")并用strings.HasPrefix()检查是否以"application/json"开头来判断JSON请求,因HTTP头大小写不敏感,建议先转小写;不可依赖Accept头、请求体花括号或c.Bind()失败反推,也不建议用字符串包含匹配以防误判变体类型。

怎么用 echo.Context 判断请求是不是 JSON
直接看 Content-Type 头,别信 Accept 或请求体有没有花括号。Echo 的 c.Request().Header.Get("Content-Type") 是最可靠的方式,但要注意:值可能带参数(比如 application/json;charset=utf-8),不能用全等匹配。
推荐用 strings.HasPrefix() 检查前缀:
if strings.HasPrefix(c.Request().Header.Get("Content-Type"), "application/json") {
// 是 JSON 请求
}
不建议用 c.Request().Method == "POST" && strings.Contains(...) 这类组合判断——PUT、PATCH 也合法传 JSON;strings.Contains 还可能误命中 application/vnd.api+json 等变体。
c.Bind() 失败时能不能反推是 JSON 格式问题
不能。因为 c.Bind() 失败的原因很多:字段类型不匹配、结构体 tag 写错、JSON 嵌套过深、甚至只是空 body。它不区分「不是 JSON」和「是 JSON 但结构不对」。
如果你需要明确区分错误类型,得先手动解析:
- 用
json.NewDecoder(c.Request().Body).Decode(&v)捕获json.SyntaxError——这才能确认是非法 JSON 字符串 - 如果解码成功但字段为空,那大概率是 JSON 合法但内容不符合预期
- 别忘了
c.Request().Body只能读一次,后续再调c.Bind()会拿到空数据
为什么 c.IsJSON() 不存在
Echo 框架本身没提供 c.IsJSON() 这样的快捷方法。这是有意为之:框架只做轻量封装,类型判断逻辑太容易出歧义(比如要不要支持 text/json?要不要忽略大小写?要不要兼容旧浏览器发的 application/x-json?)。所以把判断权留给用户,避免隐式行为导致调试困难。
如果你项目里高频使用,可以自己封装一个:
func IsJSON(c echo.Context) bool {
ct := c.Request().Header.Get("Content-Type")
return strings.HasPrefix(strings.ToLower(ct), "application/json") ||
strings.HasPrefix(strings.ToLower(ct), "text/json")
}
注意这里加了 strings.ToLower() ——HTTP 头大小写不敏感,但实际请求里可能混着 Application/JSON。
常见误判场景和坑
前端用 fetch 发请求但没设 headers: {'Content-Type': 'application/json'},后端就收不到 JSON 头;Postman 默认也不带,容易本地测试通过、上线就失败。
还有几个典型陷阱:
- 表单提交(
enctype="multipart/form-data")混传 JSON 字段,Content-Type是multipart开头,不是 JSON - 某些网关或代理会改写
Content-Type,比如强制加; charset=utf-8,影响字符串比对 - GET 请求理论上不该有 body 和 JSON 头,但有人硬塞,此时检查
Content-Type仍有效,但业务上通常应拒绝
真正关键的不是“怎么判断”,而是“判断之后做什么”——比如非 JSON 请求直接 c.NoContent(http.StatusUnsupportedMediaType),比默默忽略更利于前端定位问题。











