如果报错"error": "Unsupported Media Type"

你遇到的错误是： ``` 415 Unsupported Media Type ``` 这意味着你的请求没有被正确识别为 `multipart/form-data`，或者 Spring Boot 无法处理你发送的 JSON 字符串作为 `@RequestPart("formData")` 的内容。 --- ## 🔍 错误原因分析 ### 常见导致 `415 Unsupported Media Type` 的原因有： 1. **手动设置了错误的 `Content-Type` 头** 2. **使用了非 `FormData` 对象作为 body，但期望后端接收 multipart 数据** 3. **Spring Boot 没有配置好对 `multipart/form-data` + JSON 混合数据的支持** --- ## ✅ 正确改写后的代码（修复 415 错误） ### ✅ 修改点： - 不要手动设置 `Content-Type: application/json` - 使用原生 `FormData` 构造请求体 - 将表单字段打包成 JSON 字符串传入 `formData` 字段 - 确保文件和 JSON 都作为 `multipart/form-data` 的一部分上传 ```tsx const handleOk = () => { form.validateFields().then(async (values) => { const formData = new FormData(); // 添加表单数据：转换为 JSON 字符串 formData.append('formData', JSON.stringify(values)); // 添加文件（如果存在） if (fileList.length > 0) { formData.append('file', fileList[0]); } try { const res = await fetch('/ds/dsbaseinfo/add', { method: 'POST', body: formData, // 注意：不要包装成对象 { formData: ..., file: ... } // 不要手动设置 Content-Type，浏览器会自动处理 }); if (res.ok) { message.success(editingRecord ? '更新成功' : '新增成功'); setModalVisible(false); form.resetFields(); setFileList([]); } else { throw new Error('上传失败'); } } catch (error) { message.error('提交失败，请重试'); console.error(error); } }); }; ``` --- ## 🛠️ 后端支持要求（Spring Boot 配置） 确保你的 Spring Boot 应用具备以下依赖和配置： ### ✅ Maven 依赖（确保包含 Jackson 和 Multipart 支持）： ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> </dependency> <!-- 如果你用了自定义文件大小限制 --> <dependency> <groupId>org.apache.tomcat.embed</groupId> <artifactId>tomcat-embed-core</artifactId> </dependency> ``` ### ✅ application.yml 配置（如需调整上传大小）： ```yaml spring: servlet: multipart: enabled: true max-file-size: 10MB max-request-size: 10MB ``` --- ## ✅ Controller 示例（Java） ```java @PostMapping("/ds/dsbaseinfo/add") public ResponseEntity<String> addDsBaseInfo( @RequestPart("formData") DsBaseInfoEntity formData, @RequestPart("file") MultipartFile file ) { System.out.println("Form Data: " + formData); System.out.println("File Name: " + file.getOriginalFilename()); return ResponseEntity.ok("Success"); } ``` --- ## ✅ 调试建议（Chrome DevTools） 1. 打开 **Network** 标签页 2. 查看 `/ds/dsbaseinfo/add` 请求 3. 在 **Headers** 中确认： - `Content-Type` 是 `multipart/form-data; boundary=----...` - 请求体中包含两个 part： - `formData`: JSON 字符串 - `file`: 文件二进制内容 --- ## ✅ 可选：使用 Axios 替代 fetch（更清晰） 如果你愿意改用 Axios，可以这样写： ```tsx import axios from 'axios'; const handleOk = () => { form.validateFields().then(async (values) => { const formData = new FormData(); formData.append('formData', JSON.stringify(values)); if (fileList.length > 0) { formData.append('file', fileList[0]); } try { const res = await axios.post('/ds/dsbaseinfo/add', formData, { headers: { 'Content-Type': 'multipart/form-data' } }); if (res.status === 200) { message.success(editingRecord ? '更新成功' : '新增成功'); setModalVisible(false); form.resetFields(); setFileList([]); } } catch (error) { message.error('提交失败，请重试'); console.error(error); } }); }; ``` ---

<think>好的，用户遇到了HTTP 415 Unsupported Media Type错误，需要解决这个问题。首先，我得回忆一下相关的知识，并结合提供的引用内容来分析可能的原因和解决方法。 根据引用[1]，415错误通常是由于客户端发送的Content-Type与服务器端不兼容导致的。比如，如果客户端发送的是JSON数据但未正确设置Content-Type头，或者服务器端不支持该类型，就会触发这个错误。引用[3]提到，后端可能需要特定的库来处理JSON，比如Jackson，如果没有正确导入这些依赖，即使Content-Type正确，后端也无法解析数据，同样会导致415错误。 接下来，用户的问题可能涉及前后端配置。比如，前端发送的数据格式是否正确，请求头是否设置正确，特别是Content-Type是否正确。引用[4]中的例子显示，设置Content-Type为application/json是必要的，尤其是当发送JSON数据时。而引用[2]则提到了使用FormData时可能遇到的问题，比如boundary参数未正确生成，导致Content-Type不完整。 需要分步骤检查。首先确认客户端是否正确设置了Content-Type，并且与发送的数据格式匹配。例如，发送JSON时要设置application/json，发送FormData时要正确生成multipart/form-data并包含boundary。然后检查后端是否支持该媒体类型，是否有对应的解析库，比如Jackson。此外，引用[3]还提到了Spring MVC的配置问题，比如命名空间错误或缺少mvc:annotation-driven配置，这可能导致@RequestBody注解无法正常工作，从而无法解析请求体中的数据。 可能的解决方案包括：检查并设置正确的Content-Type头，确保前后端数据格式一致；检查后端依赖，确保引入了JSON处理库；验证Spring配置是否正确，特别是命名空间和注解驱动的配置。此外，使用工具如Postman测试请求，可以帮助确定问题是出在客户端还是服务端。 用户可能需要更详细的步骤，比如具体的代码示例如何设置请求头，或者如何添加Jackson依赖。同时，需要提醒用户检查日志，查看后端是否有更详细的错误信息，帮助定位问题。最后，总结常见原因，让用户逐一排查，这样可以系统性地解决问题。</think>要解决HTTP 415 Unsupported Media Type错误，需从客户端和服务端两方面排查，以下是分步解决方案： --- ### **一、客户端排查** 1. **检查请求头`Content-Type`** - 发送JSON数据时需显式设置：`Content-Type: application/json; charset=utf-8` - 发送FormData时自动生成：`Content-Type: multipart/form-data; boundary=xxx`（不要手动覆盖） - *代码示例（Python requests库）*： ```python # 发送JSON requests.post(url, json=data, headers={"Content-Type": "application/json"}) # 发送FormData files = {'file': open('test.txt', 'rb')} requests.post(url, files=files) # 自动生成正确header ``` 2. **验证数据格式一致性** - JSON数据需符合语法规范（无多余逗号/引号） - FormData中字段名需与后端接收参数名匹配 --- ### **二、服务端排查** 1. **检查依赖库** - 使用Spring Boot时需引入JSON解析库（如Jackson）： ```xml <!-- Maven依赖 --> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.13.1</version> </dependency> ``` 2. **验证注解和配置** - 使用`@RequestBody`接收JSON时，确保Spring MVC配置正确： ```xml <!-- 确保启用注解驱动 --> <mvc:annotation-driven/> ``` - 检查命名空间是否为标准Spring MVC（避免使用第三方命名空间如Alibaba） --- ### **三、工具调试** 1. **使用Postman测试** - 对比客户端代码与Postman的请求头、请求体是否一致 - 观察Postman是否返回相同错误，缩小问题范围[^2] 2. **查看服务端日志** - 检查是否有`HttpMediaTypeNotSupportedException`或依赖缺失的报错[^3] --- ### **常见原因总结** | 原因类型 | 具体场景示例 | 解决方法 | |----------------|----------------------------------|------------------------------| | 客户端配置错误 | 未设置`Content-Type: application/json` | 显式添加请求头 | | 服务端依赖缺失 | Spring未导入Jackson库 | 添加Maven/Gradle依赖 | | 数据格式不匹配 | JSON字段类型与后端实体类不一致 | 使用`@JsonIgnoreProperties` | ---