Gradle编译需配置tasks.withType(JavaCompile) { options.compilerArgs += ["-parameters"] }以保留方法参数名，否则反射获取为arg0/arg1；JDK≥8u60，Android项目需AGP≥7.3且JDK17+；验证用javap -v查看LocalVariableTable。
Gradle 编译必须加 -parameters 才能保留参数名
不加这个参数，Java 编译器默认擦除方法参数名（只留类型和顺序），反射调用 Parameter.getName() 就只能拿到 arg0、arg1 这类占位符。Spring MVC、MyBatis、JUnit5 参数解析等场景都会因此失败。
Gradle 中需在 compileJava 任务里显式注入该选项：
tasks.withType(JavaCompile) {
options.compilerArgs += ["-parameters"]
}
注意点：
- 必须写在
JavaCompile类型的任务上，不是compileJavatask 名本身（后者是实例，前者是类型） - 推荐用
+=而非直接赋值options.compilerArgs = [...]，避免覆盖其他可能存在的编译参数（比如-encoding UTF-8） - 该配置对所有 source set 生效（main、test 都会带上）
- JDK 版本必须 ≥ 8u60（即 JDK 8 第 60 个更新版起稳定支持，JDK 11+ 全面可用）
Android Studio / AGP 项目要额外检查 buildTools 和 JDK 版本
Android Gradle Plugin（AGP）默认不启用 -parameters，且部分旧版 AGP（如 7.2 之前）会忽略 JavaCompile 的配置。如果你在 Android 项目中发现反射仍拿不到真实参数名，得确认以下几项：
立即学习“Java免费学习笔记（深入）”；
- AGP 版本 ≥ 7.3（官方文档明确支持
-parameters的起始版本） - 项目使用 JDK 17+（Android Studio Flamingo 及以上强制要求，且 JDK 17 对
-parameters兼容性更稳） - 在
android {}块外、java {}块内再套一层配置（AGP 有时会隔离 Java 编译选项）：
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
tasks.withType(JavaCompile) {
options.compilerArgs += ["-parameters"]
}
验证 class 文件是否真含参数名信息
光配了 Gradle 不代表生效——得看最终生成的 .class 文件里有没有存下名字。最直接的验证方式是用 javap 反编译查看：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
javap -v MyClass.class | grep "Signature\|LocalVariableTable\|LocalVariableTypeTable"
如果输出中出现 LocalVariableTable 且每行有真实变量名（如 name、userId），说明成功；如果只有 arg0、arg1，就是没生效。
常见失效原因：
- IDE 没重启，或没执行
./gradlew clean compileJava（仅 Build → Rebuild Project 可能跳过 Gradle 配置） - 模块用了不同的 JDK（比如 project SDK 是 JDK 17，但
compileJava.options.fork = true却指定了旧 JDK） - 多模块项目中，只在 root
build.gradle配了，但子模块没 apply 或继承该配置
Spring Boot 启动时参数名丢失的典型表现
即使 Gradle 配对了，Spring MVC 仍可能报 Name for argument type [java.lang.String] not available，这不是反射没拿到名，而是 Spring 在运行时没读到——因为 Controller 类被 CGLIB 代理或接口代理后，原始方法元数据可能丢失。
这时要检查：
- Controller 是否用了
@Valid+BindingResult组合？这种组合会让 Spring 切换到另一种参数解析路径，绕过参数名查找 - 是否启用了
spring.aop.proxy-target-class=true（CGLIB 代理）？它可能破坏Method对象的原始引用 - 接口定义的方法（如
public interface UserService { User get(String id); }）若没在实现类上也加-parameters，代理后的调用仍会 fallback 到arg0
最稳妥的做法：所有含对外 HTTP 接口的 module，都统一加 -parameters，并确保测试阶段用反射直接读取 Method.getParameters() 验证返回值，别等上线才暴露。
