Java运行时注解需用@Retention(RetentionPolicy.RUNTIME)才能被反射读取，配合反射与动态代理实现事务、权限等逻辑；自定义时须同时满足定义、标记、处理三要素。
Java注解在运行时的作用，就是作为“可被反射读取的元数据”，触发动态逻辑——它本身不执行任何代码，但配合反射+代理，就能实现事务、权限校验、自动注入等关键能力。
为什么必须用 @Retention(RetentionPolicy.RUNTIME) 才能运行时生效
不是所有注解都能活到程序跑起来那一刻。只有明确声明为 RUNTIME 的注解，JVM 才会把它保留在字节码里，并加载进运行时类信息中，供 Class.getAnnotation() 或 Method.getAnnotation() 拿到。
- 漏加
@Retention(RetentionPolicy.RUNTIME)是最常见错误：注解写了，反射却返回null，查半天发现只是“贴了张便利贴，但没让它活到开大会那天” -
@Retention(RetentionPolicy.CLASS)（默认）只存进.class文件，JVM 不加载；SOURCE连 class 都不进，编译完就丢 - Spring 的
@Transactional、MyBatis 的@Select、JUnit5 的@Test全部依赖这个保留策略
运行时注解靠什么干活？反射 + 动态代理是标配组合
注解自己不会动，真正干活的是你写的处理逻辑——而主流框架几乎都走“反射扫描 + 代理拦截”这条路：
ImageMagick 批处理处理器
下载
使用 ImageMagick 的 convert 和 mogrify 命令进行批量图像处理，支持调整大小、裁剪、水印和格式转换。与 libvips 集成以实现高性能缩略图生成。
- 先用反射遍历所有带注解的方法，比如
clazz.getDeclaredMethods()→method.isAnnotationPresent(MyTransactional.class) - 再用 JDK 动态代理或 CGLIB，在目标方法调用前后插入逻辑（如开启事务、捕获异常、回滚）
- Spring AOP 就是典型：你写个
@Transactional，实际执行的是代理对象的invoke()，不是你原方法本身 - 直接在业务方法里手写反射读注解也能行，但别这么做——耦合高、难复用、绕过框架生命周期
自定义运行时注解三步不能少：定义、标记、处理
想让自己的注解在运行时起作用，光写个 @interface 不够，缺一不可：
立即学习“Java免费学习笔记（深入）”；
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME) // ← 必须有
public @interface LogExecutionTime {
String value() default "default";
}
- 定义时必须配齐
@Target（能贴在哪）和@Retention(RetentionPolicy.RUNTIME)（能活多久） - 使用时贴在方法/类上，比如
@LogExecutionTime("user-service") public void updateUser() { ... } - 处理逻辑得你自己写：要么注册一个 Spring
@Aspect切面，要么在启动时用反射扫描并注册回调，否则注解就是死的 - 别指望 JVM 或 javac 自动帮你执行——没有处理器，注解永远只是个标签
最容易被忽略的一点：运行时注解的价值不在“标记”，而在“谁来读、怎么用”。很多人卡在反射拿不到注解，其实问题不在注解定义，而在没确认类加载器是否一致、是否用了字节码增强工具（如 Lombok）干扰了原始类结构，或者代理层级太深导致反射拿到的是代理类而非目标类。
