如何在 Java 中通过反射机制动态获取方法定义的参数名称及其对应的详细注解信息

先说一个核心判断：Ja va反射默认是无法直接拿到方法参数“真实名字”的。比如你写了个String userName，编译后反射读出来很可能是arg0、arg1这些占位符。要想拿到userName以及它头上的@NotNull这类注解，关键就两步：编译时把参数名保留下来，再用Parameter API去读。

确保编译时保留参数名（必需步骤）

这是整个方案的前提。JDK 8+ 在这方面默认是不保留参数名的，需要在编译时显式开启。具体来说，用-parameters选项就行：

ja vac -parameters YourClass.ja va

如果你用Ma ven管理项目，在pom.xml里配置一下编译器插件：

  org.apache.ma ven.plugins
  ma ven-compiler-plugin
  3.8.1
  
    true
  

Gradle用户的话，在构建脚本里加一行：

compileJa va.options.parameters = true

用 Parameter API 获取参数名与注解

编译选项搞定之后，就可以通过Method.getParameters()拿到Parameter[]数组。每个Parameter对象都封装了参数名称、类型以及注解信息，代码写起来很直白：

Method method = YourClass.class.getDeclaredMethod("updateUser", String.class, Integer.class);
Parameter[] parameters = method.getParameters();
for (Parameter param : parameters) {
  String paramName = param.getName(); // 这里拿到的就是 "userName"、"age" 这样的真实名称
  Class paramType = param.getType(); // 比如 String.class
  Annotation[] annotations = param.getAnnotations(); // 所有运行时注解
  System.out.println("参数名: " + paramName + ", 类型: " + paramType.getSimpleName());
  for (Annotation ann : annotations) {
    System.out.println("  注解: " + ann);
  }
}

必须提醒的是：只有那些@Retention(RetentionPolicy.RUNTIME)的注解，才能通过getAnnotations()拿到手。如果注解的生命周期只到源码或类文件，反射阶段是看不见的。

获取特定类型的注解（更实用）

在实际项目中，我们往往只需要提取某一类注解，比如Spring的@RequestParam或者JSR 305的@NotNull。这时用getAnnotation(Class)会更高效：

• RequestParam reqParam = param.getAnnotation(RequestParam.class);
• NotNull notNull = param.getAnnotation(NotNull.class);
• 如果注解存在就返回实例，不存在返回null，避免空指针处理

当然，你也可以先用isAnnotationPresent(...)判断一下再取值，逻辑上会更清晰一些。

兼容 JDK 7 或未开启 -parameters 的情况

现实并不总是理想。如果你没法控制编译环境——比如依赖的是第三方jar包——那就得走一些“曲线救国”的路线了：

• 解析方法签名字符串（不推荐，既脆弱又拿不到注解信息）
• 用ASM或Ja vassist这类字节码操作库，在底层读取调试信息（复杂度高，适合框架开发者）
• 通过约定来做：比如自定义一个@MyParam(name="userId")，在运行时手动提取名称

不过对于生产项目，最标准的做法还是统一开启-parameters编译选项。这是最轻量、最可靠、也最符合JVM规范的方案。