0

0

什么是Java中的注解(Annotation)@Target与@Retention元注解解析

P粉602998670

P粉602998670

发布时间:2026-03-17 12:20:31

|

663人浏览过

|

来源于php中文网

原创

@Target 和 @Retention 是注解生效的两个硬性开关:@Target 决定注解可用位置(如 METHOD、PARAMETER),缺失则默认仅限 TYPE;@Retention 控制生命周期(SOURCE/CLASS/RUNTIME),仅 RUNTIME 支持反射获取。

什么是java中的注解(annotation)@target与@retention元注解解析

@Target 和 @Retention 不是“用来定义注解的语法糖”,而是决定一个注解“能加在哪儿”和“活到什么时候”的两个硬性开关。没配对它们,自定义注解大概率不生效。

为什么 @Target 缺失会导致注解被编译器忽略

Java 编译器看到没声明 @Target 的注解时,默认它只能用在类、接口、枚举上(即 ElementType.TYPE),其他地方比如方法参数、局部变量、返回值一写就报错:Cannot use @MyAnnotation on this element

  • 常见错误现象:给方法加了自定义注解,但运行时 getAnnotations() 拿不到;或者 IDE 直接标红
  • 必须显式声明目标位置,比如想用在方法上,就得写 @Target(ElementType.METHOD)
  • 支持多个位置?用数组:@Target({ElementType.METHOD, ElementType.PARAMETER})
  • 别漏掉 ElementType.TYPE_PARAMETER(泛型类型参数),JDK 8+ 才支持,但 Spring 5+ 里已有实际使用

@Retention 的三种策略直接影响运行时能否反射获取

@Retention 控制注解的生命周期。选错策略,Class.getAnnotations()Method.getAnnotation() 就永远为空——不是代码写错了,是注解根本没进字节码或没进 JVM 内存。

  • RetentionPolicy.SOURCE:只保留在源码期,javac 后就丢弃,IDE 可以用,但反射完全看不到
  • RetentionPolicy.CLASS:写进 class 文件,但加载时不进 JVM 方法区,反射也拿不到(多数 Lombok 注解走这条路)
  • RetentionPolicy.RUNTIME:唯一能让 getAnnotation() 成功的选项,Spring、JUnit 都依赖这个
  • 性能影响极小,但别滥用:每个 RUNTIME 注解都会增加 class 字节码体积,并在类加载时解析元数据

组合使用时最容易踩的坑:@Target 值不兼容 @Retention 范围

这不是语法错误,但会让注解在特定场景下“半失效”。比如你写了 @Target(ElementType.LOCAL_VARIABLE) + @Retention(RetentionPolicy.RUNTIME),看起来没问题,实际上——局部变量注解在 Java 中无法通过反射读取。

皮卡智能
皮卡智能

AI驱动高效视觉设计平台

下载

立即学习Java免费学习笔记(深入)”;

  • JVM 规范明确禁止运行时获取局部变量上的注解,哪怕你写了 RUNTIME,反射 API 也直接返回 null
  • 类似地,ElementType.TYPE_USE(如 List<@NonNull String>)需要配合 RUNTIME 才能在运行时用 AnnotatedType 获取,但很多老版本反射工具不支持
  • 检查 JDK 版本:JDK 8 支持 TYPE_USETYPE_PARAMETER,但 Android(Dalvik/ART)直到较新版本才逐步补全
  • IDEA/Eclipse 对 TYPE_USE 注解的提示可能滞后,建议用 javap -v 看 class 文件里是否真生成了对应 attribute

真正麻烦的是那种“看着生效、其实漏了一层”的情况:比如注解加在泛型上,@Retention(RUNTIME) 有了,@Target(TYPE_USE) 也写了,但忘了调用 Method.getAnnotatedReturnType() 而不是 Method.getReturnType() —— 这时候不是注解的问题,是你没走对反射入口。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

161

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

89

2026.01.26

eclipse教程
eclipse教程

php中文网为大家带来eclipse教程合集,eclipse是一个开放源代码的、基于Java的可扩展开发平台。就其本身而言,它只是一个框架和一组服务,用于通过插件组件构建开发环境。php中文网还为大家带来eclipse的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

197

2023.06.14

eclipse怎么设置中文
eclipse怎么设置中文

eclipse设置中文的方法:除了设置界面为中文外,你还可以为Eclipse添加中文插件,以便更好地支持中文编程。例如,你可以安装EBNF插件来支持中文变量名,或安装Chinese Helper来提供中文帮助文档。本专题为大家提供eclipse设置中文相关的各种文章、以及下载和课程。

807

2023.07.24

c语言编程软件有哪些
c语言编程软件有哪些

c语言编程软件有GCC、Clang、Microsoft Visual Studio、Eclipse、NetBeans、Dev-C++、Code::Blocks、KDevelop、Sublime Text和Atom。更多关于c语言编程软件的问题详情请看本专题的文章。php中文网欢迎大家前来学习。

627

2023.11.02

Eclipse版本号有哪些区别
Eclipse版本号有哪些区别

区别:1、Eclipse 3.x系列:Eclipse的早期版本,包括3.0、3.1、3.2等;2、Eclipse 4.x系列:Eclipse的最新版本,包括4.0、4.1、4.2等;3、Eclipse IDE for Java Developers等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

181

2024.02.23

eclipse和idea有什么区别
eclipse和idea有什么区别

eclipse和idea的区别:1、平台支持;2、内存占用;3、插件系统;4、智能代码提示;5、界面设计;6、调试功能;7、学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

153

2024.02.23

eclipse设置中文全教程
eclipse设置中文全教程

本专题整合了eclipse设置中文相关教程,阅读专题下面的文章了解更多详细操作。

119

2025.10.10

c++ 字符处理
c++ 字符处理

本专题整合了c++字符处理教程、字符串处理函数相关内容,阅读专题下面的文章了解更多详细内容。

0

2026.03.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.5万人学习

C# 教程
C# 教程

共94课时 | 11.5万人学习

Java 教程
Java 教程

共578课时 | 83.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号