Thymeleaf+Spring Boot页面返回异常：仅显示单个span标签如何解决？

核心排查方向及修复方案 #

1. 检查Thymeleaf命名空间配置 #

确保index.html根标签包含Thymeleaf命名空间，否则Thymeleaf无法识别模板，仅输出原生HTML片段：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <!-- 页面头部资源 -->
</head>
<body>
    <!-- 完整页面内容 -->
</body>
</html>

2. 修正Controller注解 #

确认Controller类使用@Controller而非@RestController——@RestController会直接将返回值作为响应体输出，不会触发视图解析流程：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HomeController {
    @GetMapping("/home")
    public String home() {
        return "index";
    }
}

3. 确认模板文件路径 #

index.html必须放在Spring Boot默认的Thymeleaf模板目录src/main/resources/templates/下。若自定义路径，需在application.properties中配置：

spring.thymeleaf.prefix=classpath:/自定义模板目录/
spring.thymeleaf.suffix=.html

4. 排查HTML语法错误 #

检查index.html是否存在未闭合标签、嵌套错误等语法问题，这类问题可能导致浏览器仅渲染部分内容。可以直接在浏览器中打开本地index.html文件，验证是否能正常显示完整页面。

5. 验证Thymeleaf依赖 #

确保项目已正确引入Thymeleaf Starter依赖，避免版本冲突或缺失：
Maven（pom.xml）

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

Gradle（build.gradle）

implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

验证方法 #

1. 启动应用后，访问http://localhost:8080/home
2. 打开浏览器开发者工具（F12），查看「网络」面板中该请求的响应体，确认是否返回完整HTML
3. 若响应体完整但显示异常，排查页面CSS/JS引用或浏览器渲染问题

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