[org.springframework.web.multipart.MultipartException: Current request is not a multipart request]

### 解决 `MultipartException` 异常的方法

当遇到 `org.springframework.web.multipart.MultipartException: Current request is not a multipart request` 的异常时，通常意味着客户端发送的HTTP请求不符合多部分表单数据的要求。以下是几种常见原因及其解决方案：

#### HTML 表单配置不当
HTML中的 `<form>` 标签如果没有正确指定编码类型，则浏览器不会按照预期格式化上传的数据。为了支持文件上传功能，必须确保表单具有如下属性：
- 编码类型需设定为 `multipart/form-data` (`enctype="multipart/form-data"`) [^3]

<form action="/upload" method="post" enctype="multipart/form-data">
    <!-- 支持选择多个文件 -->
    <input type="file" name="files" multiple>
</form>

#### 请求头设置错误
对于通过编程方式构建 HTTP 请求的情况（比如使用 Postman 或其他 API 测试工具），应当注意不要手动设置 `Content-Type` 头部信息；如果确实需要设置的话，应该将其值定为 `multipart/form-data` 而不是其他的媒体类型如 JSON [^4]。

另外，在某些情况下，即使设置了正确的头部信息，但如果实际传递的内容并不匹配所声明的形式也会引发同样的问题。例如，在Postman里测试API接口时，若选择了 binary 形式的 body 来传送文件而不是 form-data 类型并指定了相应的字段名称和文件路径，那么服务器端可能无法识别这些附件从而抛出此异常 。

#### 后端配置缺失或有误
除了前端因素外，还需要确认 Spring 应用程序本身已经适当配置了用于处理 MultipartFile 对象的支持组件。这一般涉及到了解项目中是否存在合适的 Bean 定义来解析传入的 multi-part requests 并注册到 DispatcherServlet 中去 [^1]。

具体来说就是检查是否有像 CommonsMultipartResolver 或 StandardServletMultipartResolver 这样的 bean 已经被定义好，并且其 maxUploadSize 等参数也调整得当以适应业务需求 。

---