### 解决
Spring Boot 3.4.5 集成
springdoc-openapi 后出现 `NoResourceFoundException: No static resource
favicon.ico` 的问题
在
Spring Boot 3.4.5 中集成 `
springdoc-openapi` 后，如果未正确配置静态资源路径或忽略默认的
Favicon 请求处理逻辑，则可能导致浏览器访问 API 文档页面时抛出 `NoResourceFoundException: No static resource
favicon.ico` 异常。以下是具体的解决方案：
---
#### 方法一：禁用默认
Favicon 自动加载
可以通过
设置属性来关闭
Spring Boot 默认的
Favicon 处理机制。这会阻止框架自动寻找 `
favicon.ico` 文件，从而避免因缺失文件而引发的异常。
```properties
spring.mvc.
favicon.enabled=false
```
通过上述配置[^1]，可以彻底禁用
Spring MVC 对
Favicon 的自动查找功能，防止因缺少图标文件而导致的错误。
---
#### 方法二：放置自定义
Favicon 文件
将自定义的 `
favicon.ico` 文件放入项目的 `src/main/resources/static/` 目录下，并确保其名称为 `
favicon.ico`。
Spring Boot 默认会在 `/static`, `/public`, 或其他预设目录中查找静态资源文件[^2]。
完成文件放置后，在 HTML 页面头部添加以下代码片段以显式引用该图标文件：
```html
<link rel="
icon" type="image/x-
icon" href="/
favicon.ico">
```
这种方法能够保证无论是否启用默认行为，都可以正常加载指定的图标文件。
---
#### 方法三：调整
springdoc-openapi 的资源配置
由于 `
springdoc-openapi` 提供了强大的 OpenAPI 文档生成功能，默认情况下它也会尝试加载静态资源（如 CSS、JS 和
Favicon）。因此，需要进一步优化其配置以减少不必要的冲突。
可以在 `application.properties` 或 `application.yml` 中增加以下配置项，明确指定文档接口的基础路径以及静态资源的位置：
```yaml
springdoc:
api-docs:
path: /v3/api-docs
swagger-ui:
path: /swagger-ui.html
config-url: /v3/api-docs/swagger-config
```
这些配置项可以帮助分离 OpenAPI 接口与常规 Web 应用的功能边界，降低两者之间的耦合度[^3]。
---
#### 方法四：捕获并屏蔽无关请求
为了更加优雅地处理类似 `
favicon.ico` 的无意义请求，可以在全局过滤器层面拦截此类流量并将响应状态码
设置为 `204 No Content`。具体实现方式如下所示：
创建一个基于 `OncePerRequestFilter` 的定制化过滤器类：
```
java
import org.
springframework.stereotype.Component;
import
javax.servlet.FilterChain;
import
javax.servlet.ServletException;
import
javax.servlet.http.HttpServletRequest;
import
javax.servlet.http.HttpServletResponse;
import
java.io.IOException;
@Component
public class
FaviconInterceptor extends OncePerRequestFilter {
@Override
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
throws ServletException, IOException {
if ("/
favicon.ico".equals(request.getRequestURI())) {
response.setStatus(HttpServletResponse.SC_NO_CONTENT);
return;
}
filterChain.doFilter(request, response);
}
}
```
这段代码的作用是在接收到 `/
favicon.ico` 请求时直接返回空内容而不继续向下传递请求链[^4]。
---
#### 方法五：升级依赖版本
考虑到您正在使用的
Spring Boot 版本为 3.4.5，建议同步更新至最新稳定版的 `
springdoc-openapi` 依赖库。较新的版本通常会对已知问题进行修复并改进兼容性表现。
例如，在 `pom.xml` 中声明如下依赖关系：
```xml
<dependency>
<groupId>org.
springdoc</groupId>
<artifactId>
springdoc-openapi-starter-webmvc-api</artifactId>
<version>2.1.0</version>
</dependency>
```
请注意根据实际情况替换合适的版本号[^5]。
---
### 总结
综合来看，最推荐的做法是结合 **方法一** 和 **方法二** 来实现既保留灵活性又能规避不必要的错误提示的效果。即先全局关闭内置支持再单独引入特定版本的图形标志作为替代方案。
此外，还可以借助 **方法四** 实现对特殊请求的有效隔离，从而提升系统的健壮性和用户体验。
---
本文指导你如何将ico文件重命名为favicon.ico，并将其放置在网站资源文件夹，无需额外配置，提升网站标识效率。
扫一扫
389
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
