Freemarker+Dropwizard环境下CSS文件无法加载问题咨询

别担心，这个问题其实挺普遍的，刚接触Freemarker的开发者经常会踩静态资源路径的坑。我来帮你梳理几个可行的解决方案：

1. 遵循静态资源存放的最佳实践（推荐） #

首先，建议你把CSS、JS这类静态资源从视图包（比如resource/views）移到项目专门的静态资源目录下——在Spring Boot项目中，默认的静态资源目录是src/main/resources/static或src/main/resources/public，容器会自动把这些目录下的资源映射到网站根路径/。

举个例子：

• 把styles.css放到src/main/resources/static/css/目录下
• 然后在FTL文件中用绝对路径引用：

<link rel="stylesheet" type="text/css" href="/css/styles.css">

这种方式不需要额外配置，是最规范的做法，也能避免路径混乱。

2. 配置资源处理器（如果一定要放在视图目录） #

如果你坚持要把CSS和FTL文件放在同一个包下，那需要配置Spring的资源处理器，让它能识别视图目录下的静态资源。

创建一个Web配置类，添加如下代码：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 映射/views/**路径到classpath下的/views目录
        registry.addResourceHandler("/views/**")
                .addResourceLocations("classpath:/views/");
    }
}

配置完成后，假设你的styles.css在resource/views/下，就可以这样引用：

<link rel="stylesheet" type="text/css" href="/views/styles.css">

3. 避开相对路径的陷阱 #

你之前尝试的styles.css这种相对路径很容易出问题——因为浏览器会根据当前页面的URL来解析相对路径。比如如果你的页面URL是/user/profile，浏览器会请求/user/profile/styles.css，而不是你期望的视图目录下的文件。所以一定要使用以/开头的绝对路径。

4. 优化路径引用的小技巧 #

如果你的项目部署在非根路径下（比如http://example.com/myapp/），直接写绝对路径会失效。这时候可以用Freemarker获取项目的上下文路径，配合<base>标签优化：

<head>
    <base href="${request.contextPath}/">
    <link rel="stylesheet" type="text/css" href="css/styles.css">
</head>

这样所有相对路径都会自动基于项目的上下文路径，不用在每个资源引用里重复写上下文路径。

5. 检查资源是否被正确打包 #

最后别忘了确认编译后的项目中，CSS文件确实存在对应的目录里。比如在Maven项目中，查看target/classes/static/css/下有没有styles.css，有时候IDE的打包配置可能会漏掉静态资源。

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