Jersey迁移至Spring Boot MVC：FormDataMultiPart的等效实现及多部分请求动态处理

嗨，我刚好处理过类似的Jersey到Spring MVC的迁移需求，给你分享几种实用的方案，完美替代Jersey的FormDataMultiPart，同时满足你处理JSON元数据和动态二进制文件的需求：

方案一：使用MultipartHttpServletRequest（最接近FormDataMultiPart的等效方案） #

Spring MVC提供的MultipartHttpServletRequest是处理多部分请求的“全能选手”，它能让你直接获取所有请求部分，动态性极强，和Jersey的FormDataMultiPart用法逻辑几乎一致。你可以保留已经写好的@RequestPart("myMessage")来自动绑定JSON DTO，同时通过MultipartHttpServletRequest获取所有其他二进制文件部分：

@RestController
@RequestMapping("/post")
class PostController(
    private val postService: PostService,
    private val otherService: SomeOtherService
) {
    private val logger: Logger = LoggerFactory.getLogger(PostController::class.java)

    @PostMapping(
        path = ["/digital"],
        consumes = [MediaType.MULTIPART_FORM_DATA_VALUE],
        produces = [MediaType.APPLICATION_JSON_VALUE]
    )
    fun send(
        @RequestPart("myMessage") myMessageDTO: MyMessageDTO,
        request: MultipartHttpServletRequest
    ): ResponseEntity<Any> {
        // 过滤掉已绑定的"myMessage"部分，获取所有文件part
        val fileParts = request.fileNames
            .filter { it != "myMessage" }
            .mapNotNull { request.getFile(it) }

        // 根据myMessageDTO里的标识匹配并处理文件
        fileParts.forEach { part ->
            when (part.name) {
                myMessageDTO.hoveddokument.multiPartId -> {
                    // 处理主文档（比如PDF）：获取文件名、字节流
                    val fileName = part.originalFilename ?: "unknown-document"
                    val fileBytes = part.inputStream.readAllBytes()
                    // 调用业务逻辑处理主文档
                    postService.processMainDocument(fileBytes, fileName)
                }
                else -> {
                    // 处理附件逻辑
                    otherService.processAttachment(part.inputStream, part.name)
                }
            }
        }

        // 执行其他业务逻辑并返回响应
        return ResponseEntity.ok(mapOf("status" to "success"))
    }
}

为什么推荐这个方案？ #

• 完全覆盖FormDataMultiPart的功能：可以动态遍历所有请求部分，不管客户端传多少个文件都能处理；
• 代码简洁：Spring自动帮你解析JSON到MyMessageDTO，不用手动处理序列化；
• 灵活性高：支持根据myMessageDTO里的动态标识（比如hoveddokument.multiPartId）匹配对应的文件。

方案二：手动解析指定的文件Part（适合固定名称场景） #

如果你的文件Part名称是固定的（比如明确知道主文档叫hoveddokument），也可以直接用@RequestPart绑定MultipartFile：

fun send(
    @RequestPart("myMessage") myMessageDTO: MyMessageDTO,
    @RequestPart("hoveddokument") mainDocument: MultipartFile
): ResponseEntity<Any> {
    // 直接处理主文档
    val fileBytes = mainDocument.inputStream.readAllBytes()
    // ...业务逻辑
    return ResponseEntity.ok().build()
}

不过这个方案只适合文件名称固定的场景，你的需求里文件名称是动态的（由myMessageDTO里的字段决定），所以方案一更适合你。

额外配置提示 #

Spring Boot默认已经支持multipart请求，如果你需要调整文件大小限制，可以在application.properties里添加：

# 单个文件最大大小
spring.servlet.multipart.max-file-size=10MB
# 整个请求最大大小
spring.servlet.multipart.max-request-size=10MB

内容来源于stack exchange