Spring Boot多模块项目中Thymeleaf静态资源的存放路径与问题解决

首先明确：resources/static/本身就是正确的静态资源存放位置，多模块下加载失败的核心问题通常是依赖打包逻辑、模块配置或构建缓存导致的，而非路径本身错误。以下是具体排查和解决步骤：

1. 确认模块依赖与打包逻辑 #

• 确保web模块是最终的可执行模块（即启动类所在模块），所有包含静态资源的模块都需要被web模块依赖。
• 如果资源放在非web模块的src/main/resources/static/下，必须在web模块的构建配置中添加对该模块的依赖，这样构建工具（Maven/Gradle）才会将依赖模块的静态资源合并到最终的可执行jar包中。

Maven依赖配置示例（web模块pom.xml） #

<dependency>
    <groupId>你的项目groupId</groupId>
    <artifactId>资源所在模块的artifactId</artifactId>
    <version>项目版本号</version>
</dependency>

Gradle依赖配置示例（web模块build.gradle） #

implementation project(':资源所在模块的名称')

2. 验证资源是否被正确打包 #

启动项目前，先检查web模块的构建产物目录：

• Maven：查看target/classes/static/下是否存在你的图片、CSS等资源
• Gradle：查看build/resources/main/static/下是否存在目标资源
• 如果是可执行jar，解压后检查BOOT-INF/classes/static/目录，确认资源是否被包含在内。

3. 排除自定义配置的干扰 #

• 检查web模块中是否有WebMvcConfigurer的自定义实现，如果重写了addResourceHandlers方法，必须确保保留默认的静态资源映射规则，示例：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 保留默认静态资源路径映射，避免覆盖
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/static/", "classpath:/public/", "classpath:/resources/", "classpath:/META-INF/resources/");
    }
}

• 不要随意修改spring.web.resources.static-locations配置项，除非你明确需要替换默认路径，该配置默认已经包含classpath:/static/。

4. 清理构建缓存 #

执行以下命令清理旧的构建产物，避免缓存导致资源未更新：

• Maven：mvn clean install
• Gradle：./gradlew clean build

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