SpringBoot页面加载失败：返回字符串而非Thymeleaf页面求助

针对你遇到的控制器返回"index"字符串但Thymeleaf页面未渲染的问题，可按以下步骤逐一排查：

1. 确认Thymeleaf自动配置状态 #

检查项目的application.properties或application.yml中是否存在禁用Thymeleaf的配置：

# 若存在此配置会直接禁用Thymeleaf渲染
spring.thymeleaf.enabled=false

同时确认未通过@SpringBootApplication(exclude = ThymeleafAutoConfiguration.class)排除Thymeleaf自动配置类。

2. 检查控制器注解与方法配置 #

• 确保控制器类使用的是@Controller而非@RestController（@RestController会默认给所有方法添加@ResponseBody，直接返回字符串），你的代码中已正确使用@Controller，但需确认方法上未手动添加@ResponseBody注解。
• 确认方法返回值未被其他切面或拦截器修改，导致原本的视图名称被当作响应体返回。

3. 排查视图解析器冲突 #

若项目中自定义了视图解析器（如InternalResourceViewResolver），可能会覆盖Thymeleaf的默认视图解析器，导致Spring MVC无法识别Thymeleaf模板。检查是否存在类似以下的Bean定义：

@Bean
public InternalResourceViewResolver viewResolver() {
    InternalResourceViewResolver resolver = new InternalResourceViewResolver();
    resolver.setPrefix("/WEB-INF/views/");
    resolver.setSuffix(".jsp");
    return resolver;
}

若存在此类配置，需调整优先级，确保Thymeleaf视图解析器优先生效。

4. 验证项目结构与文件路径 #

• 确认index.html确实位于src/main/resources/templates/目录下，检查目录名拼写（如是否误写为template）、文件名拼写（如是否为Index.html而非index.html，部分系统区分大小写）。
• Spring Boot默认Thymeleaf视图解析规则为：返回的视图名index对应路径classpath:/templates/index.html，无需额外配置前缀/后缀，若手动配置了spring.mvc.view.prefix或spring.mvc.view.suffix，会覆盖此默认规则，需检查是否存在此类配置。

5. 检查依赖兼容性与冲突 #

• 确认spring-boot-starter-thymeleaf依赖未被其他依赖排除，可通过./gradlew dependencies（Gradle）或mvn dependency:tree（Maven）查看依赖树，排查是否存在Thymeleaf相关依赖的版本冲突。
• 若使用Spring Boot 3.x版本，需确保Thymeleaf版本为3.1.x及以上（spring-boot-starter-thymeleaf会自动适配版本，但若手动指定了旧版本会导致兼容问题）。

6. 安全配置的潜在影响 #

虽然你已配置/search**允许匿名访问，但可补充检查：

• 安全配置中是否拦截了Thymeleaf模板的加载路径？不过此场景下页面未渲染，大概率不是静态资源拦截问题。
• sessionManagement(session -> session.sessionCreationPolicy(SessionCreationPolicy.STATELESS))不会影响Thymeleaf视图渲染（除非模板中依赖会话属性，而你当前仅返回空视图），可暂时注释此配置测试是否恢复正常。

7. 开启DEBUG日志排查 #

在application.properties中添加日志配置，查看Spring MVC处理视图的详细过程：

logging.level.org.springframework.web=DEBUG
logging.level.org.thymeleaf=DEBUG

启动项目后，访问/search，查看日志中是否存在如下关键信息：

• 是否加载了ThymeleafViewResolver
• 是否尝试解析index视图
• 是否存在模板文件未找到的错误信息

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