@Deprecated 是提示性注解，不中断编译仅触发警告，IDE 标黄是主动解析实现；它不影响运行时路由或权限控制，需配合逻辑拦截、版本路径和文档说明才能真正停用接口。
为什么 @Deprecated 不会自动报错，但 IDE 还是标黄？
因为 @Deprecated 是提示性注解，不是编译拦截器。Java 编译器默认只警告（javac 输出 note: The element X is deprecated），不中断构建；IDE（如 IntelliJ、Eclipse）则主动读取该注解并高亮，帮你提前发现调用点。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 必须配合
@Deprecated的 Javadoc 说明替代方案，否则使用者只能猜——比如写明“请改用UserService.findByIdV2(Long)” - 如果想让编译强制报错，得额外加
@SuppressWarnings("deprecation")抑制，但这是调用方的事，不是你标记时该干的 - 不要只打注解不更新 Javadoc，否则
mvn javadoc:javadoc生成的文档里看不到迁移指引
在 Spring Boot 项目里标记 Controller 方法过时，要注意什么？
Spring 本身不识别 @Deprecated 做路由控制，所以即使你标了，HTTP 请求仍能正常进来。它只影响 IDE 提示和编译警告，不等于禁用接口。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 真正停用接口，得配合逻辑拦截：在方法体开头 throw new UnsupportedOperationException("已废弃，请调用 /api/v2/users")
- 如果用 Spring WebFlux 或 Spring MVC，可加
@RequestMapping路径版本区分（如/v1/user→/v2/user），再把旧路径指向 410 Gone 响应 - 别依赖
@Deprecated当权限或路由开关——它没这个能力
@Deprecated 和 @Deprecated(since = "1.8") 参数差异在哪？
since 是 Java 9 引入的属性，仅用于记录声明废弃的版本号，对编译、运行、IDE 均无实际行为影响。它不会触发任何检查，也不会参与兼容性判断。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 写
@Deprecated(since = "2.5.0")比写@Deprecated(since = "v2.5")更规范，推荐用语义化版本格式 - 这个字段纯属信息性，JVM 不读，Maven Surefire 不读，CI 流水线也不会因此失败
- 如果团队用 Gradle +
java { toolchain { version = "17" } }，确保源码兼容性级别 ≥ 9，否则since属性会被忽略（编译不报错，但无效）
如何批量发现项目里还在调用已标 @Deprecated 的方法？
靠人眼搜 import 或 Ctrl+Click 不现实，尤其跨模块时。需要工具链介入。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- Maven 用户可在
pom.xml加<compilerargs><arg>-Xlint:deprecation</arg></compilerargs>，让mvn compile输出所有调用位置 - IntelliJ 中打开 Settings → Editor → Inspections → Java → General → “Deprecated API usage”，勾选“Show warnings in editor”和“Report when deprecated symbol is used”
- CI 阶段可用
grep -r "@Deprecated" src/main/java/ | cut -d':' -f1 | sort -u快速列出所有被标记类/方法，再反查引用
真正难的是跨服务调用——比如 A 服务标了 @Deprecated，B 服务通过 HTTP 调用它，这种完全逃逸静态分析。得靠接口文档同步、契约测试或网关层埋点告警。
