Spring Boot Thymeleaf项目中SVG图片无法加载求助

在Spring Boot + Thymeleaf项目中集成Metronic HTML登录页面，已通过以下代码成功引入CSS资源并生效：

<link th:href="@{/uploads/assets/plugins/global/plugins.bundle.css}" rel="stylesheet" type="text/css" />
<link th:href="@{/uploads/assets/css/style.bundle.css}" rel="stylesheet" type="text/css" />

但页面中的SVG图片无法显示，仅能看到alt文本“Logo”：

<!-- 无法正常显示 -->
<a href="/index.html" class="mb-7">
   <img alt="Logo" th:src="@{/uploads/assets/media/logos/logo.svg}" />
</a>

将同路径下的文件替换为PNG格式则可正常渲染：

<a href="/index.html" class="mb-7">
   <img alt="Logo" th:src="@{/uploads/assets/media/logos/logo.png}" />
</a>

• MIME类型配置缺失：Spring Boot默认可能未为SVG文件设置image/svg+xml的MIME类型，导致浏览器无法正确识别解析。需检查项目静态资源配置，确保SVG的MIME类型被正确映射。
• SVG文件本身异常：SVG文件可能存在语法错误、编码问题或文件损坏。直接在浏览器中访问SVG的绝对路径（如http://localhost:8080/uploads/assets/media/logos/logo.svg），查看能否正常渲染，或打开文件检查内容是否符合SVG规范。
• 静态资源权限限制：尽管CSS和PNG可正常访问，但SVG可能被Spring Boot的资源拦截规则限制。检查application.properties/application.yml中的静态资源配置，确认/uploads/路径下的所有文件类型（包括.svg）都允许公开访问。
• 缓存干扰：浏览器或服务器端缓存了无效的SVG资源。清空浏览器缓存，或在SVG路径后添加版本参数（如@{/uploads/assets/media/logos/logo.svg?v=1}）测试是否恢复显示。
• Thymeleaf路径解析问题：尝试直接使用绝对路径（不依赖Thymeleaf的URL表达式）加载SVG，验证是否是表达式解析环节出现异常。
• 样式冲突：Metronic的CSS可能对SVG元素设置了隐藏、尺寸为0等导致不显示的样式。通过浏览器开发者工具检查SVG元素的display、visibility、width、height等属性是否正常。

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