SpringBoot Thymeleaf 2.7.10无法加载CSS文件问题求助

错误原因 #

你遇到的报错是因为当前使用Thymeleaf的场景没有Web上下文（比如发送邮件），@{/css/styles.css}这种上下文相对路径需要依赖IWebContext接口实现，而非Web环境下Thymeleaf默认使用StandardContext，不支持这种写法。StackOverflow上的方案大多针对Web请求场景，所以对你不适用。

可行解决方案 #

1. 使用类路径绝对路径引入（非邮件场景推荐） #

直接通过classpath:前缀指定CSS的绝对位置，适配非Web环境：

<link rel="stylesheet" type="text/css" media="all" th:href="@{classpath:/static/css/styles.css}">

同时确保你的TemplateEngine配置添加资源解析器：

@Bean
public TemplateEngine templateEngine() {
    SpringTemplateEngine templateEngine = new SpringTemplateEngine();
    templateEngine.setTemplateResolver(templateResolver());
    // 添加资源URL解析器，支持类路径资源定位
    templateEngine.addUrlResolver(new SpringResourceUrlResolver());
    return templateEngine;
}

2. CSS内联（邮件场景强烈推荐） #

绝大多数邮件客户端不支持加载外部CSS文件，直接将CSS内容内联到模板的<style>标签中是最可靠的方式：

<style th:inline="text">
body {
    font-family: Arial, sans-serif;
    line-height: 1.6;
}
/* 把styles.css中的所有样式内容复制到这里 */
</style>

3. 资源相对路径（不推荐） #

依赖模板与CSS的目录结构关系，使用相对路径引入，这种方式稳定性差，目录结构变更后会失效：

<link rel="stylesheet" type="text/css" media="all" th:href="@{../../static/css/styles.css}">

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