Postman调用接口返回415错误如何解决？

Question

在使用Postman调用接口时，返回415 Unsupported Media Type错误，通常是由于请求头中Content-Type与服务器期望的格式不匹配所致。常见于POST或PUT请求中，若未正确设置Content-Type为application/json，而实际却发送了JSON数据，服务器将拒绝处理。此外，后端可能仅接受特定媒体类型，如application/xml或multipart/form-data。解决方法包括：检查并确保Headers中Content-Type准确对应请求体格式；关闭Postman自动设置Content-Type的选项以避免冲突；同时确认请求体（Body）格式与Content-Type一致。排查服务端API文档要求，是解决415错误的关键步骤。

Answer 1

深入解析Postman调用接口返回415 Unsupported Media Type错误

1. 问题现象与初步诊断

在使用Postman进行API调试时，开发者常遇到415 Unsupported Media Type的HTTP响应状态码。该错误表示服务器拒绝处理当前请求，因为请求的媒体类型不被支持。通常出现在POST或PUT请求中，当客户端发送的数据格式与服务器期望的Content-Type不一致时触发。

• 常见场景：发送JSON数据但未设置Content-Type: application/json
• 错误表现：Postman显示415状态码，响应体可能为空或提示“Unsupported Media Type”
• 初步判断：优先检查请求头中的Content-Type字段是否正确

2. 根本原因分析

415错误的核心在于MIME类型的不匹配。服务器通过Content-Type请求头来判断如何解析请求体（Body）。若该头部缺失、错误或与实际内容不符，后端框架（如Spring Boot、Express.js等）将无法正确反序列化数据，从而抛出415异常。

Content-Type值	适用场景	典型请求体格式
application/json	RESTful API JSON数据提交	{"name": "John"}
application/xml	SOAP或XML接口	<user><name>John</name></user>
multipart/form-data	文件上传或表单数据	form-data键值对
application/x-www-form-urlencoded	传统HTML表单提交	name=John&age=30

3. Postman配置排查流程图

graph TD
    A[发起POST/PUT请求] --> B{是否设置Content-Type?}
    B -- 否 --> C[手动添加正确Content-Type]
    B -- 是 --> D{Content-Type与Body格式匹配?}
    D -- 否 --> E[修正Content-Type]
    D -- 是 --> F{Postman自动设置开启?}
    F -- 是 --> G[关闭"Content-Type"自动设置]
    F -- 否 --> H[检查后端API文档]
    H --> I[确认允许的Media Type]
    I --> J[调整请求配置]
    J --> K[重新发送请求]

4. 解决方案详解

1. 检查并设置正确的Content-Type：在Postman的Headers选项卡中，确保Content-Type字段存在且值为服务器期望的类型，例如application/json。
2. 关闭Postman自动设置功能：Postman默认会根据Body类型自动添加Content-Type。建议进入Settings → General → 关闭“Automatically persist variables”及“Autocomplete headers”，避免自动注入冲突。
3. 验证Body格式一致性：若选择raw模式，需从下拉菜单中选择JSON；若使用form-data，则不应手动设置为application/json。
4. 参考API文档明确要求：查阅Swagger/OpenAPI文档或后端接口说明，确认服务端接受的consumes媒体类型，如Spring中@RequestBody标注的方法常限定consumes = "application/json"。
5. 服务端日志辅助定位：查看服务器端日志（如Tomcat、Nginx或应用日志），捕捉更详细的错误堆栈，确认是MediaTypeNotSupportedExcetion还是其他解析异常。
6. 使用cURL验证结果：将Postman请求导出为cURL命令，在终端执行，观察是否复现问题，排除工具层干扰。

5. 高级调试技巧与最佳实践

对于具备5年以上经验的开发者，可进一步采用以下策略提升排查效率：

// 示例：Spring Boot控制器中显式声明consumes
@PostMapping(value = "/users", consumes = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity createUser(@RequestBody User user) {
    // ...
}

通过显式指定consumes，可精确控制媒体类型约束。此外，结合AOP或拦截器记录入参的Content-Type和原始请求体，有助于快速定位不一致问题。在微服务架构中，还需考虑网关（如Spring Cloud Gateway）是否修改了原始Content-Type头。