如何在 Java 中通过 Method.invoke() 动态调用一个没有在代码里硬编码的方法

星瑶君_6704

星瑶君_6704

2026-04-30

956人浏览

原创

必须调用setAccessible(true)才能反射调用方法,否则抛IllegalAccessException;需处理InvocationTargetException包装、参数类型匹配、模块化访问限制及Method缓存优化。

如何在 java 中通过 method.invoke() 动态调用一个没有在代码里硬编码的方法

Method.invoke() 调用前必须确保方法可访问

反射调用失败最常见的原因是 IllegalAccessException,哪怕方法是 public 的——因为 Method 对象默认不绕过 Java 访问控制。必须显式调用 setAccessible(true) 才能触发 private/protected 方法,甚至某些模块化环境(Java 9+)下对 public 方法也需此步。

实操建议:

  • 始终在 invoke() 前加 method.setAccessible(true),别依赖“它看起来是 public 就不用”
  • 如果目标类在 module-info.java 中未导出包,setAccessible(true) 可能抛 InaccessibleObjectException,需在 JVM 启动时加 --add-opens 参数(如 --add-opens java.base/java.lang=ALL-UNNAMED)
  • 对静态方法,invoke() 的第一个参数传 null;实例方法则必须传对应对象实例,不能传 null

传参类型不匹配会导致 IllegalArgumentException

Method.invoke() 是泛型擦除后的原始方法,运行时不校验参数类型是否与声明一致,但会做基本类型自动装箱/拆箱和引用类型向上转型。一旦传入无法隐式转换的值(比如把 String 传给 int 参数),就会在运行时报 IllegalArgumentException: argument type mismatch。

实操建议:

  • 用 method.getParameterTypes() 拿到形参类型数组,手动检查并转换实参。例如:若期望 int.class,就用 Integer.parseInt(str) 或 Number.intValue()
  • 避免直接传 new Object[]{1, "hello"} 这种裸数组——如果方法签名是 void f(int, String),没问题;但如果是 void f(Integer, String),而你传了 int 字面量,会因自动装箱生效;可读性差且易错
  • 注意可变参数(String... args):传 new Object[]{"a","b"} 会被当做一个 Object[] 参数,而非展开为两个 String;正确做法是传 (Object) new String[]{"a","b"} 或单独构造数组

异常包装:实际抛出的异常被包裹在 InvocationTargetException 中

这是最容易忽略的点:Method.invoke() 不会直接抛出目标方法里 throw 的异常(比如 NullPointerException 或自定义 MyBizException),而是统一包装成 InvocationTargetException,原异常藏在 getCause() 里。

JavaStoryDevelop
JavaStoryDevelop

你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在

下载

实操建议:

  • 必须用 try-catch (InvocationTargetException e),然后调 e.getCause() 获取真实异常再处理或 rethrow
  • 如果目标方法声明抛受检异常(checked exception),反射调用时不会强制你捕获它——但 getCause() 返回的仍是那个受检异常类型,可以 instanceof 判断后强转处理
  • 不要只 catch Exception 就完事,否则会漏掉 InvocationTargetException 本身(比如底层反射机制出错),也掩盖了原始错误上下文

性能与安全:频繁反射调用要缓存 Method 实例

每次通过 Class.getMethod() 或 getDeclaredMethod() 查找 Method 对象开销不小,尤其在循环或高频路径中。而且反复调用 setAccessible(true) 也有成本。

实操建议:

  • 将查找到的 Method 对象缓存起来(如用 static final、ConcurrentHashMap 或 Guava 的 Cache),避免重复查找
  • 缓存前务必已调用过 setAccessible(true),否则每次 invoke 都得重复设
  • 注意线程安全:Method 对象本身是线程安全的,但如果你在缓存逻辑里没同步好初始化过程,可能多个线程重复创建同一 Method

真正麻烦的是跨模块调用时的 --add-opens 管理,以及异常链的逐层 unpack——这两处不细看堆栈很容易卡住半天。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11417

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8522

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7332

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1456

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3009

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20271

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1315

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习