Spring Boot无法显示greeting模板问题求助

• 刚接触Spring Boot开发，严格遵循官方入门教程操作，无法正常渲染greeting模板
• 当前网页显示异常，已准备以下信息：路由/控制台截图、application.properties配置、greeting模板代码、控制器代码、启动类代码、依赖配置
• 开发环境：使用Java 17作为编译器，系统中同时安装了Java 19
• 问题持续时间：从昨日至今

1. 统一Java版本环境 #

系统同时存在Java 17和19，需确保Spring Boot编译、运行全程使用Java 17：

• IDE项目设置：将Project SDK、Module SDK均指定为Java 17
• 系统环境变量：JAVA_HOME指向Java 17路径，PATH中Java 17的bin目录优先级高于Java 19
• 版本验证：执行 java -version 和 javac -version，确认输出均为Java 17

2. 模板引擎配置与路径校验 #

若使用Thymeleaf（官方入门教程默认模板引擎）：

• 核对application.properties配置：

  spring.thymeleaf.prefix=classpath:/templates/
  spring.thymeleaf.suffix=.html
  spring.thymeleaf.mode=HTML
  spring.thymeleaf.cache=false # 开发环境关闭缓存，避免修改不生效
  

• 检查模板文件位置：确保greeting.html位于src/main/resources/templates/目录下，文件名与控制器返回的视图名完全匹配（注意大小写，Linux/macOS系统区分大小写）

3. 控制器与路由验证 #

• 确认控制器方法返回的视图名正确，示例：

  @Controller
  public class GreetingController {
      @GetMapping("/greeting")
      public String greeting(@RequestParam(name="name", required=false, defaultValue="World") String name, Model model) {
          model.addAttribute("name", name);
          return "greeting"; // 需与templates目录下的greeting.html对应
      }
  }
  

• 访问路径正确性：确保浏览器访问URL与@GetMapping指定路径一致（如http://localhost:8080/greeting）

4. 依赖配置检查 #

确认构建文件中已正确引入模板引擎及Web依赖：

• Maven（pom.xml）示例：

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

• Gradle（build.gradle）示例：

  dependencies {
      implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
      implementation 'org.springframework.boot:spring-boot-starter-web'
  }
  

• 执行依赖刷新，确保所有依赖已正确下载

5. 控制台日志排查 #

查看Spring Boot启动及访问时的控制台日志：

• 检查是否存在TemplateInputException类报错（提示模板文件找不到），若有则再次核对模板路径和文件名
• 检查是否有依赖缺失相关报错，若有则补充对应依赖
• 确认日志中显示模板引擎已正常初始化（如Thymeleaf的加载日志）

若以上步骤无法解决问题，可补充以下信息以便进一步定位：

• 网页具体异常表现（白屏、错误代码、显示原始HTML等）
• 控制台完整报错日志
• 项目目录结构截图

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