POSTMAN请求Spring Boot接口报415错误解决方案

Question

**POSTMAN请求Spring Boot接口报415错误的常见原因有哪些？** 在使用Postman请求Spring Boot接口时，出现415 Unsupported Media Type错误通常意味着服务器无法处理请求中的媒体类型。常见原因包括：请求头中未正确设置`Content-Type`，如未指定`application/json`；发送的数据格式与`Content-Type`不匹配，例如发送表单数据却声明为JSON；后端未配置相应的消息转换器，导致无法解析请求体；或Spring Boot版本更新后默认配置变化，未启用对JSON的自动解析。解决此问题需检查请求头、数据格式及后端配置，确保一致性。

Answer 1

一、POSTMAN请求Spring Boot接口报415错误的常见原因

在使用Postman请求Spring Boot接口时，出现415 Unsupported Media Type错误通常意味着服务器无法处理请求中的媒体类型。该错误的根源通常涉及客户端请求格式与服务端解析能力之间的不匹配。以下将从浅入深，逐步分析常见原因及排查思路。

1. 请求头未正确设置 Content-Type

HTTP请求头中的 Content-Type 字段用于告知服务器请求体的数据格式。若未设置或设置错误，Spring Boot将无法识别数据格式，从而返回415错误。

• 未设置 Content-Type: application/json，但请求体为JSON数据。
• 误将 Content-Type 设置为 application/xml，但发送的是JSON内容。

解决方案：在Postman的Headers标签页中，确保设置了正确的 Content-Type 值。

2. 请求体数据格式与 Content-Type 不匹配

即使设置了正确的 Content-Type，如果实际发送的数据格式与声明的类型不符，Spring Boot仍会报错。

Content-Type	应发送的数据格式	常见错误示例
application/json	标准JSON格式字符串	发送表单格式（key=value）却声明为JSON
application/x-www-form-urlencoded	表单格式字符串	发送JSON却声明为表单格式

3. Spring Boot未配置对应的消息转换器

Spring Boot默认会注册JSON消息转换器（如Jackson），但如果项目中未引入相关依赖或手动禁用了自动配置，可能导致无法解析JSON请求体。

例如，缺少以下依赖可能导致415错误：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
</dependency>
    

此外，若在配置类中手动禁用了 spring.mvc.async.request-closed-publish-event 或移除了 HttpMessageConverters，也可能导致问题。

4. Spring Boot版本升级导致默认配置变化

在Spring Boot 2.x之后，部分默认配置发生了变化。例如，某些版本默认不再启用对某些格式的自动解析，需显式配置。

例如，在Spring Boot 2.6及以上版本中，若未启用 @EnableWebMvc 或未正确配置 WebMvcConfigurer，可能导致消息转换器未正确注册。

@Configuration
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List> converters) {
        converters.add(new MappingJackson2HttpMessageConverter());
    }
}
    

5. 使用了不兼容的POST请求体格式

在Postman中发送POST请求时，Body选项卡有多种格式：raw、form-data、x-www-form-urlencoded等。若选择错误，也会导致415错误。

• 使用raw格式时，需选择JSON格式并正确编写JSON内容。
• 使用form-data时，每个字段为键值对，适用于文件上传或表单提交。

错误示例：在raw中选择Text格式，但发送JSON内容，此时 Content-Type 可能被误设为 text/plain。

6. 自定义过滤器或拦截器中断了请求处理

某些项目中可能自定义了请求拦截器或过滤器，如安全验证、日志记录等。若在这些组件中未正确处理请求体或未调用 chain.doFilter()，也可能导致Spring Boot无法继续处理请求体，从而返回415错误。

7. 使用了不支持的字符编码

若请求体使用了服务器不支持的字符集（如UTF-16），也可能导致解析失败。建议统一使用UTF-8编码。

8. 调试工具或代理中间件修改了请求头

某些情况下，如使用Nginx、网关服务或代理工具（如Charles），可能在转发请求时修改了 Content-Type 或请求体内容，导致Spring Boot解析失败。

9. Spring Boot应用未启用自动检测

在某些Spring Boot模块化项目中，若未启用自动配置，如未使用 @SpringBootApplication 注解主类，可能导致消息转换器未被正确加载。

10. Postman缓存或插件干扰

Postman本身也可能存在缓存问题或插件冲突，导致请求头或请求体未按预期发送。建议清除缓存或使用新窗口重试。

11. 错误使用GET请求携带请求体

GET请求理论上不应携带请求体，但在某些场景下开发者可能尝试发送。Spring Boot默认不会解析GET请求的body，若强制解析，也可能报415错误。

12. 客户端序列化错误

若客户端使用了某些库（如Axios、Fetch API）发送请求，若未正确序列化JSON，可能导致 Content-Type 正确但实际内容格式错误。

13. 图解：415错误的排查流程

graph TD
            A[开始] --> B[检查Postman请求头]
            B --> C{Content-Type是否正确?}
            C -->|是| D[检查请求体格式]
            C -->|否| E[设置正确的Content-Type]
            D --> F{格式是否匹配?}
            F -->|是| G[检查Spring Boot配置]
            F -->|否| H[调整Postman Body格式]
            G --> I{是否有消息转换器?}
            I -->|是| J[检查Spring Boot版本兼容性]
            I -->|否| K[添加Jackson依赖或启用@EnableWebMvc]
            J --> L{是否启用自动配置?}
            L -->|是| M[排查过滤器或拦截器]
            L -->|否| N[启用自动配置或手动添加转换器]