springboot 3.x MultipartFile 参数总是为空 参数传递不进来

场景：

在写一个统一文件上传的时候，MultipartFile参数一直传递不进来，一直为空。

排错方法：

我先是将业务简化，使用api文档进行测试，测试是前端问题还是后端问题。

简化后业务：

用apifox文档测试之后，还是显示报错

{
    "code": 500,
    "message": "Required part 'file' is not present.",
    "result": null,
    "type": "error"
}

代表其实servlet请求体里根本没有这个文件流参数，跟文件名和参数名没有太大关系，而且文件上传springboot是默认打开的，也不需要显示的去打开

  # 数据源配置
  servlet:
    multipart:
      enabled: true
      max-file-size: 20MB
      max-request-size: 20MB

之后一直根据这个报错信息去查找相关文档，发现出现这个问题的有很多种原因，那就一个一个去排查

1.前后端参数名对应不一致
2.spring.servlet.multipart.enabled=false即关闭文件上传支持
3.配置文件中指定了文件上传时的大小值问题
4.切换内嵌容器tomcat到undertow的配置问题
5.spring.servlet.multipart.location=/tmp指定了临时文件站，但路径不存在
6.多次读取HttpServletRequest流
7.springboot已经有CommonsMultipartResolver，需要排除原有的Multipart配置@EnableAutoConfiguration(exclude = {MultipartAutoConfiguration.class})

一个个排查之后，发现自己在请求体到接口之前就被使用过多次，很符合多次读取HttpServletRequest流的问题

就是这里使用了：

import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;

/**
 * CachedBodyHttpServletRequest 扩展了 HttpServletRequestWrapper 类，
 * 用于缓存请求体，使其可以被多次读取。
 */
public class CachedBodyHttpServletRequest extends HttpServletRequestWrapper {

    private final byte[] cachedBody;

    /**
     * 构造函数，读取请求体并进行缓存。
     *
     * @param request 原始的 HttpServletRequest
     * @throws IOException 如果发生 I/O 错误
     */
    public CachedBodyHttpServletRequest(HttpServletRequest request) throws IOException {
        super(request);

        // 读取请求体并将其转换为字节数组
        InputStream requestInputStream = request.getInputStream();
        this.cachedBody = requestInputStream.readAllBytes();
    }

 

发现了问题，就好解决了，找到在哪里调用了这个请求体缓存，写这个缓存的目的也是为了解决请求体不能被多次使用的问题，因为我有一个自动检测验证码的拦截器需要去拦截登录接口的参数，

之前是方法没有注意，本来是不应该有这个错误的，第一个是没有正确在缓存里配置文件流的操作，第二个是验证码拦截器并没有针对登录接口专门做，而是都拦截了下来，导致都是用的这个缓存

 

之后就修改一下代码就好了,让这个拦截器只拦截登录接口的时候处理业务:

@Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
        // 检查请求 URL 和方法
        String url = request.getRequestURI();
        if ("/bt/login".equals(url) && request.getMethod().equals("POST")) {
            // 包装请求，缓存请求体
            CachedBodyHttpServletRequest cachedBodyHttpServletRequest = new CachedBodyHttpServletRequest(request);
            try {
                // 解析请求体
                LoginUserDto loginUserDto = JSON.parseObject(cachedBodyHttpServletRequest.getReader(), LoginUserDto.class);

                // 验证码校验逻辑
                if (loginUserDto.getCode() == null || !loginUserDto.getCode().equals(redisUtil.get(RedisKeys.CAPTCHA + loginUserDto.getUuid()))) {
                    throw new CaptchaException("验证码错误");
                }

                // 验证码正确，删除验证码
                redisUtil.del(RedisKeys.CAPTCHA + loginUserDto.getUuid());
            } catch (CaptchaException e) {
                // 交给认证失败处理器
                loginFailureHandler.onAuthenticationFailure(cachedBodyHttpServletRequest, response, e);
                return;
            }
            // 继续处理请求
            filterChain.doFilter(cachedBodyHttpServletRequest, response);
        }
        filterChain.doFilter(request, response);
    }

到此，顺利解决问题。

{
    "code": 0,
    "message": "操作成功",
    "result": "url访问地址...",
    "type": "success"
}