Spring参数转换异常：MethodArgumentConversionNotSupportedException求助

问题原因 #

你通过@RequestParam注解接收ValidationCreationDTO类型的参数，但Spring默认仅支持将简单类型（如String、Integer）绑定到@RequestParam，无法自动将字符串转换为自定义DTO对象，因此触发转换异常。

解决方案 #

方案1：手动转换JSON字符串为DTO #

将requestBody参数改为String类型接收，再通过Jackson的ObjectMapper手动解析为DTO：

public ResponseEntity<DocumentBaseResponse> validateAndCreate(@RequestParam(name = "requestBody") String requestBodyStr, @RequestParam(name = "file") MultipartFile file, HttpServletRequest request) {
    ObjectMapper objectMapper = new ObjectMapper();
    ValidationCreationDTO requestBody;
    try {
        requestBody = objectMapper.readValue(requestBodyStr, ValidationCreationDTO.class);
    } catch (JsonProcessingException e) {
        // 处理JSON解析异常，比如返回参数错误响应
        return ResponseEntity.badRequest().build();
    }
    // 后续业务逻辑
}

注意：前端需确保requestBody参数传递的是合法的JSON字符串。

方案2：使用@RequestPart接收混合请求（推荐） #

改用@RequestPart注解替代@RequestParam，Spring会自动解析多部分请求中的JSON内容为DTO，同时支持文件上传：

public ResponseEntity<DocumentBaseResponse> validateAndCreate(@RequestPart("requestBody") ValidationCreationDTO requestBody, @RequestPart("file") MultipartFile file, HttpServletRequest request) {
    // 后续业务逻辑
}

前端要求：请求类型为multipart/form-data，其中requestBody字段需设置Content-Type为application/json，值为JSON格式的参数内容。

方案3：自定义类型转换器 #

实现Spring的Converter接口，让框架自动完成字符串到DTO的转换：

@Component
public class StringToValidationCreationDTOConverter implements Converter<String, ValidationCreationDTO> {
    private final ObjectMapper objectMapper;

    // 依赖注入ObjectMapper
    public StringToValidationCreationDTOConverter(ObjectMapper objectMapper) {
        this.objectMapper = objectMapper;
    }

    @Override
    public ValidationCreationDTO convert(String source) {
        try {
            return objectMapper.readValue(source, ValidationCreationDTO.class);
        } catch (JsonProcessingException e) {
            throw new IllegalArgumentException("ValidationCreationDTO参数格式错误", e);
        }
    }
}

添加该转换器后，Spring会自动将@RequestParam接收的字符串转换为ValidationCreationDTO对象，同样要求前端传递合法JSON字符串。

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