可能原因及解决方案

1. CORS配置问题

• 原因：前后端跨域请求未配置CORS，导致请求被拦截。
• 解决方案：

  • 在Controller方法或类上添加 @CrossOrigin 注解：

    @CrossOrigin(origins = "http://front-end-domain")
    @PostMapping("/upload")
    public ResponseEntity<?> uploadFile(...) { ... }
    

  • 全局配置CORS：

    @Configuration
    public class WebConfig implements WebMvcConfigurer {
        @Override
        public void addCorsMappings(CorsRegistry registry) {
            registry.addMapping("/upload").allowedOrigins("*");
        }
    }
    

2. CSRF保护拦截

• 原因：Spring Security默认启用CSRF保护，需携带CSRF Token。
• 解决方案：
  • 前端发送请求时携带CSRF Token（如放在请求头X-XSRF-TOKEN）。
  • 关闭CSRF保护（仅限测试环境）：

    @EnableWebSecurity
    public class SecurityConfig extends WebSecurityConfigurerAdapter {
        @Override
        protected void configure(HttpSecurity http) throws Exception {
            http.csrf().disable();
        }
    }
    

3. Spring Security路径未放行

• 原因：上传接口路径未在安全配置中开放访问权限。
• 解决方案：

  @EnableWebSecurity
  public class SecurityConfig extends WebSecurityConfigurerAdapter {
      @Override
      protected void configure(HttpSecurity http) throws Exception {
          http.authorizeRequests()
              .antMatchers("/upload").permitAll() // 放行上传接口
              .anyRequest().authenticated();
      }
  }
  

4. 请求头Content-Type错误

• 原因：前端未设置 Content-Type: multipart/form-data。
• 解决方案：
  • 确保前端请求头正确设置：

    const formData = new FormData();
    formData.append('file', file);
    fetch('/upload', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer ' + token // 若需鉴权
      },
      body: formData
    });
    

5. 文件大小或类型限制

• 原因：上传文件超出Spring Boot默认大小限制，或类型被禁止。
• 解决方案：

  • 配置application.properties放宽限制：

    spring.servlet.multipart.max-file-size=10MB
    spring.servlet.multipart.max-request-size=10MB
    

  • 配置允许的MIME类型（如图片）：

    @Bean
    public MultipartResolver multipartResolver() {
        var resolver = new StandardServletMultipartResolver();
        // 或自定义MultipartConfigElement设置allowedMimeTypes
        return resolver;
    }
    

6. 请求方法不匹配

• 原因：API期望POST但前端使用其他方法。
• 解决方案：
  • 确保Controller方法使用@PostMapping，前端使用POST请求。

解决方案对比表格

总结

• 优先排查顺序：CORS → Security配置 → 请求头 → 文件大小/类型 → CSRF。
• 常见误区：403通常与权限或安全配置相关，而非文件存储路径权限（路径权限问题一般报500或异常）。