Spring Boot多段字段蛇形命名序列化失效问题求助

我有一个Restful API，需同时上传文件并发送其他数据，因此选用multipart-data格式（相比base64更具性能优势）。我希望请求参数采用蛇形命名（snake case），但目前必须使用实体类MyCustomRequest中定义的驼峰命名（camel case）才能正确反序列化。例如发送参数custom_file无法映射到属性customFile，且@JsonProperty注解对multipart请求不生效。我希望统一使用蛇形命名以保持前后端（尤其是Typescript类型定义）的一致性，恳请提供解决思路。

代码示例 #

Controller代码 #

@PutMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<Object> send(
    @PathVariable Integer id,
    @Valid MyCustomRequest request
) {
    // 业务逻辑
}

请求实体类 #

@Data
public class MyCustomRequest   {
    @JsonProperty("custom_file")
    @NotNull
    private MultipartFile customFile;

    @JsonProperty("time_saved")
    @Size(max = 1000)
    private String timeSaved;

    @Size(max = 1000)
    private String comment;
}

1. 局部绑定：使用@RequestParam指定参数名 #

Spring处理multipart/form-data请求时，不会通过Jackson解析参数，而是直接按表单字段名匹配实体类属性，因此@JsonProperty不生效。可以在实体类属性上添加@RequestParam注解，明确指定蛇形命名的参数名：

修改后的MyCustomRequest：

@Data
public class MyCustomRequest {
    @RequestParam("custom_file")
    @NotNull
    private MultipartFile customFile;

    @RequestParam("time_saved")
    @Size(max = 1000)
    private String timeSaved;

    @RequestParam("comment")
    @Size(max = 1000)
    private String comment;
}

前端发送custom_file、time_saved、comment字段即可正确映射到对应的驼峰属性，无需修改Controller代码。

2. 全局转换：自定义参数解析器 #

如果多个接口需要统一处理蛇形到驼峰的参数映射，可以自定义HandlerMethodArgumentResolver实现全局转换：

步骤1：实现自定义解析器

@Component
public class SnakeCaseMultipartResolver implements HandlerMethodArgumentResolver {

    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        // 匹配带有@Valid注解的自定义实体类参数，或标注了@Data的实体类
        return parameter.hasParameterAnnotation(Valid.class) ||
               parameter.getParameterType().isAnnotationPresent(Data.class);
    }

    @Override
    public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer,
                                  NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {
        Class<?> paramClass = parameter.getParameterType();
        Object requestObj = paramClass.getDeclaredConstructor().newInstance();
        WebDataBinder binder = binderFactory.createBinder(webRequest, requestObj, parameter.getParameterName());

        HttpServletRequest request = (HttpServletRequest) webRequest.getNativeRequest();
        // 处理普通表单参数
        Map<String, String[]> paramMap = request.getParameterMap();
        for (Map.Entry<String, String[]> entry : paramMap.entrySet()) {
            String snakeName = entry.getKey();
            String camelName = snakeToCamel(snakeName);
            trySetFieldValue(requestObj, camelName, entry.getValue()[0]);
        }

        // 处理文件参数
        Collection<Part> parts = request.getParts();
        for (Part part : parts) {
            String snakeName = part.getName();
            String camelName = snakeToCamel(snakeName);
            trySetFieldValue(requestObj, camelName, request.getPart(snakeName));
        }

        // 触发参数校验
        binder.validate();
        BindingResult result = binder.getBindingResult();
        if (result.hasErrors()) {
            throw new MethodArgumentNotValidException(parameter, result);
        }

        return requestObj;
    }

    // 蛇形命名转驼峰命名
    private String snakeToCamel(String snakeCase) {
        StringBuilder camelCase = new StringBuilder();
        boolean toUpper = false;
        for (char c : snakeCase.toCharArray()) {
            if (c == '_') {
                toUpper = true;
            } else {
                camelCase.append(toUpper ? Character.toUpperCase(c) : c);
                toUpper = false;
            }
        }
        return camelCase.toString();
    }

    // 反射设置实体类字段值
    private void trySetFieldValue(Object obj, String fieldName, Object value) {
        try {
            Field field = obj.getClass().getDeclaredField(fieldName);
            field.setAccessible(true);
            field.set(obj, value);
        } catch (NoSuchFieldException | IllegalAccessException e) {
            // 忽略不存在的字段，或根据业务需求处理
        }
    }
}

步骤2：注册解析器

在Spring配置类中添加解析器注册：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Autowired
    private SnakeCaseMultipartResolver snakeCaseMultipartResolver;

    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        resolvers.add(snakeCaseMultipartResolver);
    }
}

配置完成后，所有符合条件的multipart/form-data请求参数都会自动从蛇形转换为驼峰，实体类无需额外添加@RequestParam，同时可以保留@JsonProperty兼容JSON格式的请求。

3. 尝试全局配置（局限性） #

Spring Boot提供了参数命名策略配置，但该配置仅对普通表单参数生效，对MultipartFile类型参数不适用。可以尝试在application.yml中添加：

spring:
  mvc:
    property-naming-strategy: SNAKE_CASE

如果文件参数仍无法映射，建议结合方案1或方案2使用。

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