Spring Boot CRUD失效、Thymeleaf页面不渲染问题求助

按你遇到的三个问题，按优先级从高到低排查即可：

一、访问路由返回字符串、不渲染HTML页面 #

这个问题是视图解析链路失效导致，按以下顺序检查：

• 确认pom.xml（Gradle项目对应build.gradle）中已正确引入spring-boot-starter-thymeleaf依赖，未引入该依赖时Spring MVC不会加载Thymeleaf视图解析器，会直接将Controller返回的字符串作为响应体输出。
• 检查Controller类的注解：视图层Controller必须使用@Controller注解，绝对不能在类上添加@RestController、@ResponseBody注解，这两个注解会绕过视图解析流程，直接把返回值输出到响应体。
• 检查模板文件位置：所有HTML页面必须放在resources/templates目录下，不要错放到resources/static目录；如果在application.yml/application.properties中自定义了Thymeleaf配置，确认前缀、后缀配置正确：

  # 正确配置参考
  spring.thymeleaf.prefix=classpath:/templates/
  spring.thymeleaf.suffix=.html
  spring.thymeleaf.cache=false # 开发环境关闭缓存方便调试
  

• 确认Spring Boot版本和Thymeleaf版本对应，不要混用跨大版本的依赖，版本不兼容也会导致视图解析失败。

二、访问/student/save报405 Method Not Allowed错误 #

这个是符合设计预期的正常拦截，不是代码bug：

• 新增、更新类的提交接口本身就应该只允许POST请求访问，浏览器地址栏直接发起的是GET请求，自然会被拦截返回405，不要用直接输入地址的方式测试这类提交接口。
• 检查前端表单的method属性必须设置为post，如果表单写的是method="get"，提交时就会触发这个405错误。
• 检查Controller中save方法的注解配置，必须和表单提交方法一致，比如使用@PostMapping("/save")标注接口。

三、新增、更新、删除按钮操作失效 #

按从前端到后端的顺序逐层排查：

• 先打开浏览器开发者工具（F12）的网络面板，点击按钮后查看实际发起的请求：
  • 如果请求根本没发出去，先检查前端按钮的点击事件、表单的action路径是否写对，有没有JS报错阻断流程
  • 如果请求发出去了返回404，检查请求路径和Controller里的接口路径是否完全匹配
  • 如果请求返回405，检查请求方法和接口要求的方法是否匹配（注意：原生HTML表单仅支持GET/POST方法，如果你的删除/更新接口用了PUT/DELETE方法，要么配置HiddenHttpMethodFilter支持_method参数转换，要么直接改成POST接口）
• 检查参数绑定：表单内所有输入项的name属性值，必须和后端接收的Student实体类字段名完全一致，否则会出现参数绑定失败，后端接收到的字段为null，导致操作数据库失败。
• 检查后端组件扫描配置：
  • Service实现类必须加@Service注解
  • JPA Repository接口必须能被SpringBoot启动类扫描到
  • 涉及数据修改的Service方法（更新、删除）必须加@Transactional注解，否则JPA会报无事务权限错误
• 检查JPA实体映射：Student实体类必须正确标注@Entity、@Table、@Id注解，字段和数据库表列一一对应，数据库连接配置正确，控制台如果有SQL执行报错，优先解决SQL语法、字段不匹配的问题。

调试技巧：在Controller每个接口方法第一行加断点或者打印日志，点击按钮时如果断点没触发，说明请求没到后端，优先排查前端配置、路由映射；如果断点触发了，就逐行调试看参数接收、Service执行、数据库操作环节具体报什么错，顺着报错信息定位即可。

内容的提问来源于stack exchange，提问作者Impulse International School