Spring MVC中Favicon使用疑问：原有非Spring配置为何失效？

Hey there! I’ve run into this exact issue before when moving from plain web apps to Spring MVC—let’s break down the key differences and get that favicon showing up again.

Core Differences from Non-Spring Apps #

• Request Interception by DispatcherServlet: In your old setup, the web server (like Tomcat) directly handled requests for static files like favicon.png. But Spring MVC’s DispatcherServlet is configured to intercept all incoming requests by default. If you haven’t told Spring to serve static resources explicitly, it’ll try to route the favicon request to a Controller (which doesn’t exist), resulting in a silent 404 that browsers often hide instead of throwing an obvious error.

• Relative Path Resolution: Spring MVC adds a context path to your application (unless you deploy it as the root app), which can break relative paths like ../resources/images/favicon.png. The relative path that worked before might now point to a non-existent location because the request’s base URL has changed.

• Browser Caching: It’s easy to overlook, but browsers love caching favicons. Even if you fix the server-side issue, your browser might still be showing an old cached version (like a blank icon) instead of the new one.

Fixes to Try #

1. Configure Static Resource Mapping #

Tell Spring MVC to handle requests for your static resources by adding a resource handler. Here’s how to do it in both Java Config and XML:

Java Config (Spring Boot or Annotation-Based MVC)

@Configuration
@EnableWebMvc
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // Map requests to /resources/** to the /resources/ directory in your webapp
        registry.addResourceHandler("/resources/**")
                .addResourceLocations("/resources/");
    }
}

XML Configuration

<beans xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/mvc
                           http://www.springframework.org/schema/mvc/spring-mvc.xsd">

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

Then update your link tag to use an absolute path (using the app’s context path to avoid relative path issues):

<link rel="shortcut icon" href="${pageContext.request.contextPath}/resources/images/favicon.png" />

2. Place Favicon in the Root Directory #

Most browsers automatically look for /favicon.ico at the root of your application. If you rename your favicon.png to favicon.ico and place it directly in your webapp root directory, you might not even need the link tag—Spring MVC will serve it if you’ve configured static resource handling (or if your server allows access to root static files).

3. Clear Browser Cache #

Sometimes the simplest fix is to force a hard refresh: press Ctrl + Shift + R (Windows/Linux) or Cmd + Shift + R (Mac) to bypass the cache. You can also clear your browser’s cache manually to ensure it fetches the new favicon.

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