Spring Boot POST请求问题：无法从客户端调用控制器

Hey there! Let's work through this problem step by step—first, I'll spot the obvious issues in your code, then walk through common fixes and checks to get your POST request working.

First: Fix Critical Syntax & Code Errors #

Looking at your snippet, there are a few immediate issues that would prevent your controller from being recognized or working:

1. Your UploadController class definition has invalid syntax (public class UploadController()—the parentheses shouldn't be there). This will cause a compile error, so Spring can't even detect your controller.
2. Your request mapping method is incomplete (get(Mo...), and you're using a generic @RequestMapping instead of a @PostMapping (which is standard for file uploads).
3. The upload directory logic needs clearer definition and error handling.

Here's a corrected version of your code:

MyApplication.java

@SpringBootApplication
public class MyApplication {
    public static void main(String[] args) {
        try {
            // Reference the upload dir from your controller
            File uploadDirectory = new File(UploadController.UPLOAD_DIR);
            // Create directory (and parent folders if needed) if it doesn't exist
            if (!uploadDirectory.exists()) {
                boolean isCreated = uploadDirectory.mkdirs();
                if (isCreated) {
                    System.out.println("Upload directory created at: " + uploadDirectory.getAbsolutePath());
                } else {
                    System.err.println("Failed to create upload directory—check file permissions!");
                }
            }
            SpringApplication.run(MyApplication.class, args);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

UploadController.java

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;

@RestController
public class UploadController {
    // Define your Tomcat upload path (adjust this to your actual Tomcat webapps directory)
    public static final String UPLOAD_DIR = "/opt/tomcat/webapps/upload/";

    // Explicitly use @PostMapping for file uploads, and specify the content type
    @PostMapping(value = "/test", consumes = "multipart/form-data")
    public ResponseEntity<String> uploadImage(@RequestParam("file") MultipartFile file) {
        // Validate the incoming file
        if (file.isEmpty()) {
            return ResponseEntity.badRequest().body("Please select a file to upload");
        }

        try {
            // Create the destination file
            File destFile = new File(UPLOAD_DIR + file.getOriginalFilename());
            // Save the uploaded file to the Tomcat directory
            file.transferTo(destFile);
            return ResponseEntity.ok("File uploaded successfully: " + destFile.getAbsolutePath());
        } catch (IOException e) {
            e.printStackTrace();
            return ResponseEntity.internalServerError().body("Upload failed: " + e.getMessage());
        }
    }
}

Next: Troubleshoot the POST Request Call #

Once your code compiles and runs, check these common issues if you still can't call the controller:

• Verify the request URL: If your Spring Boot app uses a context path (configured via server.servlet.context-path in application.properties), add that prefix to your URL (e.g., http://localhost:8080/your-app-context/test).
• Check request content type: Ensure your client sends the request with Content-Type: multipart/form-data—this is mandatory for file uploads.
• Configure file size limits: Add these lines to application.properties to avoid size-related errors:

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

• Validate Tomcat permissions: Make sure the user running your Spring Boot app has write access to the UPLOAD_DIR path. Without this, the file save will fail silently or throw an exception.
• Test with a simple client: Use a tool like Postman or curl to rule out client-side issues. Example curl command:

  curl -X POST -F "file=@/path/to/your/local/image.jpg" http://localhost:8080/test
  

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