SpringBoot整合Thymeleaf时Bootstrap未生效，求排查方案

Hey there! Let's figure out why your Bootstrap styles aren't loading in your Spring Boot + Thymeleaf app. This is a super common issue, and usually boils down to one of a few key things—let's walk through them step by step:

Spring Boot automatically looks for static assets (like CSS/JS) in these default directories:

• src/main/resources/static
• src/main/resources/public
• src/main/resources/resources
• src/main/resources/META-INF/resources

If you downloaded Bootstrap manually, make sure your files are placed correctly. For example:

src/main/resources/static/css/bootstrap.min.css
src/main/resources/static/js/bootstrap.bundle.min.js

Putting files outside these folders means Spring Boot can't find them.

Thymeleaf requires you to use its @{...} syntax to generate correct resource URLs—plain relative paths can break, especially if your app has a context path. Here's the right way to link Bootstrap:

<!-- Correct Thymeleaf syntax -->
<link rel="stylesheet" th:href="@{/css/bootstrap.min.css}">
<script th:src="@{/js/bootstrap.bundle.min.js}"></script>

<!-- Wrong: Plain relative paths might fail -->
<link rel="stylesheet" href="css/bootstrap.min.css">

The @{...} expression handles context paths automatically, ensuring the browser requests the right URL.

If you're pulling Bootstrap via WebJars instead of manual downloads, double-check your pom.xml dependency:

<dependency>
    <groupId>org.webjars</groupId>
    <artifactId>bootstrap</artifactId>
    <version>5.3.2</version> <!-- Match your desired version -->
</dependency>

Then link to the WebJar path (make sure the version matches your pom):

<link rel="stylesheet" th:href="@{/webjars/bootstrap/5.3.2/css/bootstrap.min.css}">
<script th:src="@{/webjars/bootstrap/5.3.2/js/bootstrap.bundle.min.js}"></script>

Open your browser's developer tools (F12) and check two tabs:

• Console: Look for 404 errors—this means the browser can't find your Bootstrap files. Fix the path in your HTML.
• Network: Check the status of the Bootstrap resource requests. A 404 confirms a path issue.

Sometimes old cached resources or Spring Boot DevTools caching can prevent updates:

• Force-refresh your browser with Ctrl+F5 (Windows) or Cmd+Shift+R (Mac).
• If using DevTools, add these lines to application.properties to auto-refresh static resources:

  spring.devtools.livereload.enabled=true
  spring.devtools.restart.additional-paths=src/main/resources/static
  

Thymeleaf expects HTML templates to live in src/main/resources/templates. If your index.html is outside this folder, Spring Boot won't process it with Thymeleaf—meaning the @{...} expressions won't resolve, and your links will break.

If you've created a custom WebMvcConfigurer bean, make sure you haven't overridden static resource mappings incorrectly. For example:

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // Ensure this includes your static resource path
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/static/");
    }
}

A misconfigured handler can block Spring Boot from finding your static assets.

Here's a quick example of a correct project structure to reference:

src/
├── main/
│   ├── resources/
│   │   ├── static/
│   │   │   ├── css/
│   │   │   │   └── bootstrap.min.css
│   │   │   └── js/
│   │   │       └── bootstrap.bundle.min.js
│   │   └── templates/
│   │       └── index.html
│   └── java/
│       └── com/yourpackage/YourSpringBootApplication.java
└── pom.xml

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