Spring Boot演示应用端点映射404错误求助

核心排查与修复步骤 #

• 验证控制器配置

  • 确保控制器类添加了@RestController（适用于REST接口）或@Controller + @ResponseBody（返回字符串/JSON场景）注解，缺少注解会导致Spring无法识别该类为请求处理类。
  • 检查@GetMapping("/ciao")（或@RequestMapping）的路径是否完全匹配，Spring Boot默认路径大小写敏感，避免拼写或大小写错误。
  • 确认控制器类位于HelloApplication.java的同级包或子包下，默认@SpringBootApplication会自动扫描主类所在包及子包；若控制器在外部包，需显式指定@ComponentScan(basePackages = "你的控制器包路径")。

• 简化依赖配置

  • 移除不必要的依赖：tomcat-embed-jasper用于JSP页面渲染，spring-data-rest-hal-explorer用于REST数据接口可视化，这两个依赖和普通REST端点无关，反而可能干扰配置。
  • 确保pom.xml中包含核心Web依赖：

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

• 检查主应用类

  • 主类HelloApplication.java只需保留@SpringBootApplication注解，该注解已整合@ComponentScan、@EnableAutoConfiguration、@Configuration，无需额外重复添加@ComponentScan（除非需要扫描外部包）。

• 示例正确代码参考
  若你未编写对应控制器，需新增如下类：

  import org.springframework.web.bind.annotation.GetMapping;
  import org.springframework.web.bind.annotation.RestController;
  
  @RestController
  public class CiaoController {
      @GetMapping("/ciao")
      public String sayCiao() {
          return "Ciao!";
      }
  }
  

• 查看启动日志
  启动应用后，检查控制台日志是否存在类似Mapped "{[/ciao],methods=[GET]}"的输出，若没有则说明控制器未被扫描到，需重新检查包结构或扫描配置。

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