Java反射无法获取方法参数名的根本原因是编译时未启用-parameters参数，导致字节码不保留参数名信息；需JDK 8+、编译配置-parameters、注意Lombok兼容性及运行时用isNamePresent()校验。
Java反射拿不到方法参数名的真正原因
不是反射本身有问题，而是编译时默认不保留参数名信息。JVM字节码里方法签名只存类型（如 (Ljava/lang/String;I)V），不存 name 或 age 这种名字——除非你主动告诉编译器“留着”。
常见错误现象：Parameter.getName() 返回 arg0、arg1，甚至抛 UnsupportedOperationException（某些老版本 JDK）。
- 必须用 JDK 8+，且编译时加
-parameters参数 - IDE（如 IntelliJ）默认不开启该选项，Maven/Gradle 也要显式配置，光改代码没用
- 哪怕加了
-parameters，如果用了 Lombok 的@AllArgsConstructor或@RequiredArgsConstructor，生成的构造器参数名仍可能丢失——因为 Lombok 在编译期生成字节码，未必继承原始参数名元数据
Maven项目中启用-parameters的实操配置
只改 pom.xml 的 maven-compiler-plugin 配置，别碰 IDE 的 Java Compiler 设置（两者不联动）。
关键点：JDK 版本声明和编译参数必须匹配，否则 -parameters 被静默忽略。
立即学习“Java免费学习笔记（深入）”；
- 确保
<source></source>和<target></target>≥ 8（推荐设为11或更高） - 在
<configuration></configuration>下加<compilerargs><arg>-parameters</arg></compilerargs> - 如果用了 Spring Boot，注意
spring-boot-maven-plugin不影响编译，别配错插件
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>17</source>
<target>17</target>
<compilerArgs><arg>-parameters</arg></compilerArgs>
</configuration>
</plugin>
运行时用反射安全读取参数名的写法
别直接调 method.getParameters()[0].getName() —— 没开 -parameters 时会返回无意义的 arg0，且无法区分是“真叫 arg0”还是“没拿到名字”。得先检查是否可用。
- 用
Parameter.isNamePresent()判断当前参数名是否真实存在（返回true才可信） - 不要依赖
toString()或日志打印整个Parameter对象，它可能隐藏真实状态 - 如果业务强依赖参数名（比如 Web API 自动绑定），建议启动时做一次校验：遍历关键类的方法，断言
isNamePresent() == true，失败则抛异常或告警
for (Parameter p : method.getParameters()) {
if (!p.isNamePresent()) {
throw new IllegalStateException("Missing parameter name for " + p.getType().getSimpleName());
}
String name = p.getName(); // 此时才安全使用
}
Lombok与-parameters共存时的坑
Lombok 1.18.20+ 默认支持 -parameters，但有三个典型断裂点：
-
@Builder生成的内部类（如XXXBuilder）方法不继承原始参数名，需手动加@Builder(toBuilder = true)并验证 -
@Data的toString()不受影响，但它的hashCode()/equals()方法参数名无关，无需担心 - 最隐蔽的是：Lombok 编译插件和 maven-compiler-plugin 的执行顺序。若用
lombok-maven-plugin，必须确保它在 compile phase 之前运行，否则-parameters元数据被覆盖
验证方式很简单：反编译 class 文件，看 MethodParameters attribute 是否存在（用 javap -v YourClass.class | grep MethodParameters）。
参数名这件事，本质是编译期契约——你得让源码、编译器、字节码工具、运行时环境全部对齐，漏一环就回到 arg0。
