POST /imports无映射问题求助：Spring Boot Controller配置排查

问题分析与解决方案 #

1. 重复注解导致路径映射不匹配

你的createImport方法同时使用了@PostMapping和@RequestMapping(value = "/", method = RequestMethod.POST)，结合类上的@RequestMapping("/imports")，实际映射的路径是/imports/（带尾部斜杠），而你请求的是/imports。Spring默认严格匹配路径，这直接导致映射找不到。

解决：
移除重复的@RequestMapping注解，仅保留@PostMapping并指定consumes类型：

@PostMapping(consumes = "multipart/form-data")
public ImportModel createImport(@RequestParam("file") MultipartFile file) throws IOException {
    // 原有业务代码
}

修改后，类上的/imports与方法的@PostMapping组合，正好匹配POST /imports请求。

2. 确认Controller是否被Spring扫描

如果启动日志中没有输出ImportController initialized.，说明该Controller未被Spring容器加载：

• 检查启动类（带@SpringBootApplication的类）所在包是否包含demo包。如果启动类在com.example这类外层包，需在启动类添加@ComponentScan(basePackages = {"demo"})指定扫描路径。

3. 移除不必要的@MultipartConfig注解

Spring Boot已经自动配置了文件上传相关的MultipartResolver，@MultipartConfig是Servlet原生注解，添加后可能与Spring的自动配置冲突。建议移除该注解，文件大小限制可通过配置文件设置：
在application.properties中添加：

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

4. 检查Postman请求配置

• 确保请求使用form-data格式，键名设置为file（与方法中@RequestParam("file")一致）。
• 不要手动设置请求头的Content-Type为multipart/form-data，Postman会自动生成包含boundary的正确请求头，手动设置会导致请求格式错误。

修改后的完整Controller代码 #

package demo;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.io.IOException;
import javax.annotation.PostConstruct;

@RestController
@RequestMapping("/imports")
public class ImportController {
    @Autowired
    private ImportRepository importRepository;

    @PostConstruct
    public void init() {
        System.out.println("ImportController initialized.");
    }

    // Create a new import
    @PostMapping(consumes = "multipart/form-data")
    public ImportModel createImport(@RequestParam("file") MultipartFile file) throws IOException {
        // Save the file to the server's file system
        Path filePath = Paths.get("", file.getOriginalFilename());
        file.transferTo(filePath);

        // Create an ImportModel object with the file path and save it to the database
        ImportModel importModel = new ImportModel();
        importModel.setFilename(file.getOriginalFilename());
        importModel.setFilePath(filePath.toString());
        return importRepository.save(importModel);
    }
}

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