如果你刚跑起一个全新的 Spring Boot 项目，打开 localhost:8080，然后盯着浏览器标签页里那片默认的绿叶图标发呆——你就知道是时候换掉它了。那片小绿叶确实是 Java 开发者的荣誉徽章，但你的用户期望看到的是你真正的品牌 Logo。

看看 Stripe 或 GitHub 这些公司是如何处理他们的 Web 应用的。他们绝不会在生产环境中留下框架的默认图标。他们提供的是清晰、经过优化的图标，在页面还没渲染完之前就能建立起用户的信任感。缺失图标或使用默认图标，只会让人觉得这是一个“还没做完的业余项目”。

很多老旧的教程会告诉你，随便扔个 ICO 文件到 static 文件夹里就完事了。我强烈建议你别停在那一步。现在是 2026 年，你需要的是一套能处理高分屏和暗黑模式的现代方案，同时还要能和 Spring 严格的路由规则完美配合。

快速修复：静态文件夹法

Spring Boot 对静态资源有内置的魔法。默认情况下，它会在特定的类路径目录中寻找名为 favicon.ico 的文件，并自动将其映射到根 URL (/favicon.ico)。

第一步：准备你的图标文件

首先，你需要一个真正的 ICO 文件。千万别只是把 PNG 的后缀改成 ICO（浏览器非常讨厌这种做法）。使用 Mzu favicondl 从你的 Logo 生成一个包含多分辨率的规范 ICO 文件。

第二步：把它放到正确的目录

将新生成的 favicon.ico 放到你 Spring Boot 项目的以下任一目录中：

重启你的应用。当你访问根 URL 时，那片绿叶应该就不见了，取而代之的是你的自定义图标。

现代方法：Thymeleaf 与 HTML 标签

仅仅依赖浏览器对根目录 favicon.ico 的隐式请求是一个过时的习惯。浏览器确实会去请求它，但这让你无法控制 Apple Touch 图标或现代的 SVG 格式。

你应该在 HTML 模板中显式声明你的图标。如果你使用的是 Thymeleaf（Spring 的标准模板引擎），你可以创建一个可复用的 <head> 片段。

<!-- 在你的 fragments/head.html 中 -->
<link rel='icon' type='image/svg+xml' href='/icons/favicon.svg'>
<link rel='icon' type='image/png' href='/icons/favicon-96x96.png' sizes='96x96'>
<link rel='apple-touch-icon' href='/icons/apple-touch-icon.png'>

将这些文件放在 src/main/resources/static/icons/ 目录下。这明确告诉浏览器到底该加载什么，完全绕过了后备的根目录请求。如果你想复习一下具体该用哪些标签，可以看看我们的添加 Favicon 的 HTML 指南。

避坑指南：Spring Security 拦截了你的图标

这是 90% 的 Java 开发者都会卡住的地方。你把文件放到了正确的文件夹，也加了 HTML 标签，但是浏览器标签页还是一片空白。你打开 DevTools 的网络面板，看到一个 404 Not Found 或者一个跳转到登录页的 302 Redirect。

如果你的类路径里有 Spring Security，它默认会保护所有的端点——包括静态资源。当浏览器尝试获取 /favicon.ico 时，Spring Security 会拦截这个未认证的请求并将其屏蔽。

如何修复安全过滤器链

你需要明确告诉 Spring Security 忽略对 favicon 和静态图标目录的请求。打开你的安全配置类，更新你的 SecurityFilterChain Bean：

@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    http
        .authorizeHttpRequests(auth -> auth
            .requestMatchers('/favicon.ico', '/icons/**').permitAll()
            .anyRequest().authenticated()
        )
        .formLogin(Customizer.withDefaults());
    return http.build();
}

通过添加 requestMatchers('/favicon.ico', '/icons/**').permitAll()，你允许浏览器在用户登录之前就获取你的品牌图标。这对于让登录页面本身看起来更专业至关重要。

常见问题排查

即使 Spring 配置完美，图标可能还是显示不出来。以下是常见的背锅侠：

由于路由和安全层的存在，自定义 Spring Boot 的 favicon 确实比纯静态 HTML 网站要多费点心思。但干掉那片默认的绿叶，是你将本地 Java 项目转变为生产级 Web 应用的第一步。