Alright, let's break down what's going on here and fix this image upload issue step by step. Your core problem is that the relative path you're using for uploads is being resolved against Tomcat's runtime working directory (instead of your project's webapp folder), which is why files are ending up in the Tomcat ROOT directory instead of your project's WEB-INF/images.

1. First, Verify MultipartResolver Configuration #

Spring MVC can't handle file uploads without a MultipartResolver bean. Check your Servlet-context.xml to make sure you have one configured:

<!-- Option 1: Use Commons FileUpload dependency -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="5242880"/> <!-- Limit to 5MB -->
</bean>

<!-- Option 2: Use Tomcat's built-in resolver (Servlet 3.0+ compatible) -->
<bean id="multipartResolver" class="org.springframework.web.multipart.support.StandardServletMultipartResolver"/>

If you go with the second option, add multipart config to your web.xml for the DispatcherServlet:

<servlet>
    <servlet-name>dispatcher</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/Servlet-context.xml</param-value>
    </init-param>
    <multipart-config>
        <max-file-size>5242880</max-file-size>
        <max-request-size>5242880</max-request-size>
    </multipart-config>
    <load-on-startup>1</load-on-startup>
</servlet>

2. Fix the Upload Path: Get the Real Project Deployment Path #

Using WEB-INF/images directly as a relative path won't work because Tomcat resolves relative paths from its bin directory (not your project's webapp folder). Instead, use ServletContext to get the actual filesystem path of your webapp folder:

In your EmusicController, inject ServletContext and build the correct upload path:

@Controller
public class EmusicController {

    @Autowired
    private ServletContext servletContext;

    @PostMapping("/addProduct")
    public String handleProductUpload(@RequestParam("productImage") MultipartFile file, Product product) throws IOException {
        // Get the real filesystem path of /WEB-INF/images in your deployed project
        String uploadDir = servletContext.getRealPath("/WEB-INF/images/");
        File uploadDirectory = new File(uploadDir);
        
        // Create directory if it doesn't exist
        if (!uploadDirectory.exists()) {
            uploadDirectory.mkdirs();
        }

        // Use original filename (or generate a unique one to avoid overwrites)
        String fileName = file.getOriginalFilename();
        File destFile = new File(uploadDir + fileName);
        
        // Save the uploaded file
        file.transferTo(destFile);

        // Store the path in your Product object for database persistence
        product.setImagePath("/WEB-INF/images/" + fileName);
        
        // Add your product save logic here...
        return "redirect:/products";
    }
}

3. A Critical Note: WEB-INF Files Can't Be Accessed Directly by the Frontend #

Files in WEB-INF are protected by the server—your JSPs won't be able to load images with <img src="/WEB-INF/images/xxx.jpg">. A better approach is to move your images to a public directory like webapp/resources/images, then configure resource mapping in Servlet-context.xml:

<mvc:resources mapping="/images/**" location="/resources/images/"/>

Now you can access images with <img src="/images/xxx.jpg">, and adjust your upload path to:

String uploadDir = servletContext.getRealPath("/resources/images/");

4. Double-Check Your JSP Form's enctype #

Make sure your AddProduct.jsp form has the correct enctype—without this, file uploads won't work at all:

<form action="/addProduct" method="post" enctype="multipart/form-data">
    <!-- Your other product fields here -->
    <input type="file" name="productImage" />
    <button type="submit">Save Product</button>
</form>

Follow these steps, and your images should start uploading to the correct directory in your project instead of Tomcat's ROOT folder.

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