Spring Boot中如何合并JSON与Multipart表单的同参数POST接口？

你可以通过以下几种方式复用同一套业务逻辑，让Spring Boot自动适配两种请求编码格式，避免重复编写控制器方法：

1. 快速方案：抽离核心逻辑，入口方法转发 #

先把两个控制器方法里的重复业务逻辑抽成私有方法，再让两个入口方法仅负责参数绑定并调用核心逻辑，这是改造现有代码最快的方式：

步骤1：抽离核心处理逻辑 #

private Mono<ResponseEntity<Object>> handlePostStatus(Principal user, V1PostStatus body) {
    // 这里放置原两个控制器方法中的所有业务代码，只写一次
}

步骤2：简化两个入口方法 #

保留两个请求类型的入口，但只做参数绑定：

@PostMapping(value = "/api/v1/statuses", consumes = MediaType.APPLICATION_JSON_VALUE)
Mono<ResponseEntity<Object>> postApiV1StatusesJson(Principal user, @RequestBody V1PostStatus body) {
    return handlePostStatus(user, body);
}

@PostMapping(value = "/api/v1/statuses", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
Mono<ResponseEntity<Object>> postApiV1StatusesForm(Principal user, @ModelAttribute V1PostStatus body) {
    // 用@ModelAttribute替代分散的@RequestPart，Spring会自动将表单字段绑定到DTO对象
    return handlePostStatus(user, body);
}

2. 细节适配：解决DTO绑定的特殊场景 #

嵌套对象绑定 #

对于poll这类嵌套对象，客户端提交表单时需要用点分隔的字段名（如poll.options、poll.expires_in），Spring会自动将这些字段绑定到嵌套的V1PostPoll对象中。如果客户端提交的是poll字段的JSON字符串，需要额外处理（参考下文全局配置方案）。

布尔类型参数转换 #

表单提交的布尔值通常是字符串（"true"/"false"），Spring默认可自动转换，但如果存在空字符串等异常情况，可通过@InitBinder注册自定义转换器：

@InitBinder
public void initBinder(WebDataBinder binder) {
    binder.registerCustomEditor(boolean.class, new PropertyEditorSupport() {
        @Override
        public void setAsText(String text) throws IllegalArgumentException {
            setValue(text != null && (text.equalsIgnoreCase("true") || text.equals("1")));
        }
    });
}

3. 进阶方案：全局配置让@RequestBody同时支持两种请求 #

如果多个端点都需要适配两种请求类型，可以自定义HttpMessageConverter，让Spring将Multipart请求直接转换为DTO，从而只保留一个控制器方法：

步骤1：实现自定义消息转换器 #

public class MultipartFormDataToDtoConverter implements HttpMessageConverter<Object> {

    private final ObjectMapper objectMapper;

    public MultipartFormDataToDtoConverter(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    @Override
    public boolean canRead(Class<?> clazz, MediaType mediaType) {
        return MediaType.MULTIPART_FORM_DATA.includes(mediaType);
    }

    @Override
    public boolean canWrite(Class<?> clazz, MediaType mediaType) {
        return false;
    }

    @Override
    public List<MediaType> getSupportedMediaTypes() {
        return Collections.singletonList(MediaType.MULTIPART_FORM_DATA);
    }

    @Override
    public Object read(Class<?> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException {
        ServletServerHttpRequest request = (ServletServerHttpRequest) inputMessage;
        MultipartHttpServletRequest multipartRequest = (MultipartHttpServletRequest) request.getServletRequest();

        // 将表单参数转为Map，再转换为DTO
        Map<String, Object> dtoMap = new HashMap<>();
        multipartRequest.getParameterMap().forEach((key, values) -> {
            if (values.length == 1) {
                dtoMap.put(key, values[0]);
            } else {
                dtoMap.put(key, values);
            }
        });

        // 处理嵌套的poll字段（如果客户端提交的是JSON字符串）
        if (dtoMap.containsKey("poll")) {
            String pollJson = (String) dtoMap.get("poll");
            V1PostStatus.V1PostPoll poll = objectMapper.readValue(pollJson, V1PostStatus.V1PostPoll.class);
            dtoMap.put("poll", poll);
        }

        return objectMapper.convertValue(dtoMap, clazz);
    }

    @Override
    public void write(Object o, MediaType mediaType, HttpOutputMessage httpOutputMessage) throws IOException {
        // 无需实现，仅处理请求读取逻辑
    }
}

步骤2：注册转换器到Spring容器 #

@Configuration
public class WebConfig implements WebMvcConfigurer {

    private final ObjectMapper objectMapper;

    public WebConfig(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        converters.add(new MultipartFormDataToDtoConverter(objectMapper));
    }
}

步骤3：简化为单一控制器方法 #

现在只需要保留一个方法，即可同时处理JSON和Multipart请求：

@PostMapping(value = "/api/v1/statuses", consumes = {MediaType.APPLICATION_JSON_VALUE, MediaType.MULTIPART_FORM_DATA_VALUE})
Mono<ResponseEntity<Object>> postApiV1Statuses(Principal user, @RequestBody V1PostStatus body) {
    // 核心业务逻辑
}

注意事项 #

• 数组类型参数（如media_ids），客户端提交时需用media_ids[]或多个同名参数，Spring会自动绑定到String[]类型。
• 如果客户端采用嵌套字段名（而非JSON字符串）提交嵌套对象，可去掉转换器中处理poll的代码，Spring的@ModelAttribute会自动完成绑定。

内容的提问来源于stack exchange，提问作者Benjamin Reed