一、从基础入手：@GetMapping 的基本用法与导入方式
在 Spring Boot Web 开发中，@GetMapping 是一个非常常用的注解，用于将 HTTP GET 请求映射到特定的控制器方法上。
它本质上是 @RequestMapping 注解的一个快捷方式，等价于：
@RequestMapping(method = RequestMethod.GET)要使用该注解，必须导入如下类：
import org.springframework.web.bind.annotation.GetMapping;如果没有正确导入该类，IDE 会提示“无法解析符号 @GetMapping”，这是最常见的问题之一。
二、深入分析：Spring Boot 项目结构与依赖配置
除了导入注解类，还需要确保项目中引入了 Spring Web 模块。通常，Spring Boot 项目通过 Maven 或 Gradle 管理依赖。
Maven 依赖示例：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>Gradle 依赖示例：
implementation 'org.springframework.boot:spring-boot-starter-web'如果未引入该依赖，即使正确导入注解类，也会导致运行时报错。
三、版本兼容性：Spring Boot 不同版本对 @GetMapping 的支持
@GetMapping 是从 Spring Framework 4.3 开始引入的。因此，使用 Spring Boot 1.5 及以上版本时，均可正常使用。
| Spring Boot 版本 | @GetMapping 支持情况 |
|---|---|
| 1.5.x | 支持 |
| 2.0.x - 2.7.x | 支持 |
| 3.0.x（Spring 6） | 支持 |
如果使用的是低于 1.5 的版本，建议升级 Spring Boot 或改用 @RequestMapping。
四、常见问题汇总与排查流程
在实际开发中，开发者常遇到以下问题：
- IDE 报错：“Cannot resolve symbol @GetMapping”
- 运行时报错：“Annotation @GetMapping is not applicable to this type of declaration”
- 找不到请求路径，GET 请求未被正确映射
以下是排查流程图：
graph TD
A[开始] --> B{是否导入@GetMapping类?}
B -- 否 --> C[手动导入org.springframework.web.bind.annotation.GetMapping]
B -- 是 --> D{是否引入spring-web依赖?}
D -- 否 --> E[添加spring-boot-starter-web依赖]
D -- 是 --> F{是否为GET方法且路径正确?}
F -- 否 --> G[检查方法签名和URL路径]
F -- 是 --> H[问题已解决]
五、扩展：Spring MVC 注解体系与最佳实践
除了 @GetMapping，Spring MVC 还提供了多个常用的 HTTP 方法注解：
- @PostMapping - 映射 POST 请求
- @PutMapping - 映射 PUT 请求
- @DeleteMapping - 映射 DELETE 请求
- @PatchMapping - 映射 PATCH 请求
这些注解的使用方式与 @GetMapping 类似，都需要正确导入对应的类，并确保项目依赖完整。
建议开发者在开发初期就统一导入 Spring Web 模块，并使用 IDE 的自动导入功能，避免手动遗漏。
