Spring Boot控制器返回字符串而非渲染HTML页面问题求助

1. 检查模板引擎依赖是否正确引入 #

Spring Boot需要模板引擎（如Thymeleaf）来解析并渲染HTML视图，若未引入对应依赖，框架会直接将返回的字符串作为响应体输出。

• 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'

2. 确认控制器类注解 #

若控制器类使用了@RestController，会默认将所有返回值直接作为响应体返回（等价于@Controller + @ResponseBody），不会触发视图解析流程。需确保控制器类标注的是@Controller。

3. 校验视图配置与文件路径 #

• 确认src/main/resources/templates目录存在，且Success.html文件位于该目录下，文件名大小写需与返回字符串完全匹配（Spring Boot默认大小写敏感）。
• 你的application.properties配置是正确的，无需修改：

spring.mvc.view.prefix=classpath:/templates
spring.mvc.view.suffix=.html

4. 改用重定向优化（推荐） #

为避免表单重复提交，同时确保走正确的视图渲染流程，可将POST方法改为重定向到GET的成功页面接口，通过RedirectAttributes传递跨重定向参数：

@PostMapping("/add")
public String processAddUserForm(
        @RequestParam String name,
        @RequestParam String email,
        @RequestParam Integer age,
        @RequestParam String dept,
        @RequestParam Integer salarey,
        @RequestParam String password,
        RedirectAttributes redirectAttributes) {
    // 创建新用户并保存到数据库
    User newUser = new User();
    newUser.setName(name);
    newUser.setEmail(email);
    newUser.setAge(age);
    newUser.setDept(dept);
    newUser.setSalarey(salarey);
    newUser.setPassword(password);

    userRepository.save(newUser);

    // 传递跨重定向参数
    redirectAttributes.addFlashAttribute("name", name);

    // 重定向到成功页面接口
    return "redirect:/success";
}

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