spring boot中@getmapping未生效的常见原因及解决方案

在 Spring Boot 中，@GetMapping 注解本身不会自动绑定到浏览器直接访问的根路径 / —— 这是初学者最容易误解的关键点。你当前的代码：

@GetMapping
public List hello() { ... }

看似“无参”@GetMapping 应该响应 http://localhost:8080/，但实际上 @GetMapping 不加路径参数时等价于 @GetMapping("/")，而 Spring Boot 默认已为 / 配置了静态资源处理器（如 ResourceHttpRequestHandler）和欢迎页逻辑（如 index.html），优先级高于你的控制器方法。因此请求 / 并不会进入你的 hello() 方法，而是触发默认的 404 处理流程，最终显示 Whitelabel Error Page。

✅ 正确做法：显式声明路径，并通过匹配的 URL 访问

修改你的 @GetMapping 为带路径的版本，例如：

@GetMapping("/students")
public List getAllStudents() {
    return List.of(
        new Student(
            1L,
            "Mariam",
            "[email protected]",
            LocalDate.of(2000, Month.JANUARY, 5),
            21
        )
    );
}

然后在浏览器中访问：
? http://localhost:8080/students

此时 Spring MVC 才会正确路由到该方法，并以 JSON 格式返回学生列表（前提是项目已引入 spring-boot-starter-web 且 Jackson 依赖可用）。

⚠️ 其他关键注意事项：

• 包结构与组件扫描：确保 Demo2Application 类位于最外层包（如 com.example.demo），而 Student 类位于子包（如 com.example.demo.Student）。Spring Boot 默认只扫描启动类所在包及其子包。你当前的 @SpringBootApplication 和 @RestController 合并在一个类上虽可运行，但建议分离关注点：将 @RestController 移至独立的 Controller 类（如 StudentController），放在 com.example.demo.controller 包下，更符合规范。

• Student 类的序列化支持：LocalDate 默认可被 Jackson 序列化（Spring Boot 2.2+ 内置 jackson-datatype-jsr310），但请确认 pom.xml

  

  中包含：

  
      org.springframework.boot
      spring-boot-starter-web
  

  ✅ 该 starter 已自动引入 Jackson 和 JSR-310 支持，无需额外配置。

• 避免路径冲突与隐式覆盖：不要将 @GetMapping 留空或设为 "/"，尤其当项目后续添加 index.html、favicon.ico 或 Actuator 端点时，极易引发路由冲突。

? 补充调试技巧：

• 启动后查看控制台日志中的 Mapped "{[/students],methods=[GET]}" 日志行，确认端点是否成功注册；
• 使用 curl -v http://localhost:8080/students 或 Postman 测试，排除浏览器缓存或重定向干扰；
• 若仍报错，检查 application.properties 是否误配了 server.servlet.context-path 或 spring.mvc.servlet.path。

总结：@GetMapping 必须配合明确、唯一、未被占用的路径使用；根路径 / 属于保留区域，切勿用于业务接口。遵循 RESTful 命名惯例（如 /api/v1/students）不仅解决当前问题，也为后续扩展打下坚实基础。