Parameter类：Java 8获取变量方法的参数名称

来聊一个Ja va开发中容易被忽略，但实际很关键的小细节：方法参数名。不少朋友在写框架、做反射或者搞RPC的时候，都遇到过这种情况——明明在代码里写了有意义的参数名，比如 username、age，可一运行时通过反射拿到的却是 arg0、arg1……这其实是编译器的“锅”。Ja va 8 之后，只要做一个小配置，就能让真相浮出水面。

Ja va 8+需启用-parameters编译参数才能通过Method.getParameters()获取真实参数名，否则返回arg0等占位符；Ma ven、IDEA和命令行均需显式配置，这是实现按名自动注入的前提。

从 Ja va 8 开始，ja va.lang.reflect.Parameter 类正式登场。一个前提是，编译时必须加 -parameters 选项，这样参数名信息才会被写进 class 文件的 MethodParameters 属性里，运行时才能读得到。

启用参数名保留（编译关键）

默认情况下，ja vac 会把参数名擦掉，只保留类型和顺序。所以你得主动告诉它：别删。方式有三种：

• 命令行直接加 -parameters：ja vac -parameters MyClass.ja va
• Ma ven 项目里改 pom.xml 的编译插件配置：

  
    org.apache.ma ven.plugins
    ma ven-compiler-plugin
    3.11.0
    
      8
      8
      
        -parameters
      
    
  

• IDE 里也要记得打开“Store method parameter names”或类似选项，否则代码写得再漂亮，编译结果里也还是空白。

用 Parameter 获取参数名

具体怎么做？通过 Method.getParameters() 拿到 Parameter[] 数组，然后每个 Parameter 对象的 getName() 就是你要的名字：

public class UserService {
  public void updateUser(String username, int age) {
  }
}

// 反射获取
Method m = UserService.class.getMethod("updateUser", String.class, int.class);
Parameter[] params = m.getParameters();
for (Parameter p : params) {
  System.out.println(p.getName()); // 输出: username, age（前提是编译带 -parameters）
}

有一点很贴心：Parameter.isNamePresent() 可以用来判断参数名是否真的存在。如果编译没加 -parameters，getName() 就会返回 arg0 这样的默认名。先判断一下可以避免踩坑。

常见误区与限制

• 仅对方法/构造器有效：字段、局部变量、Lambda 参数都不适用，别指望能通吃。
• 不是运行时“推断”或“解析源码”：这个名字完全来自编译期嵌入的调试信息（MethodParameters 属性），跟注释、命名约定没有半毛钱关系。
• 匿名类、Lambda 表达式中无法获取：这些方法由 JVM 合成，参数名通常不可见，或者就是 arg0 这样的占位符。
• 泛型类型擦除不影响参数名：参数名和泛型类型信息（比如 List）是两套独立机制。想拿泛型类型，得用 getGenericParameterTypes()。

实用场景举例

这个能力的真正价值，体现在框架层面，能给开发者省不少事：

• Spring MVC：绑定请求参数时，如果控制器方法参数没加 @RequestParam("xxx")，只要开启了 -parameters，就能自动按参数名匹配 query 字段，少写很多注解。
• MyBatis Plus：方法只有一个参数时，@Param 注解可以省略；多个参数时，如果编译保留了名字，也能免写 @Param（依赖 MyBatis 3.4+ 和 -parameters）。
• 自定义注解处理器或 RPC 框架：生成接口文档时，直接提取真实参数名而不是 arg0，可读性瞬间提升，开发体验也更友好。