MyBatis-Plus 反射访问异常问题分析与解决方案

问题背景

在使用 MyBatis-Plus 进行数据库操作时，开发者可能会遇到一个特殊的反射访问异常问题。该问题表现为：在项目启动初期运行正常，但运行一段时间后（通常几十分钟后），在执行 update 和 remove 操作时会出现 InaccessibleObjectException 异常，提示无法访问 java.lang.reflect.Proxy.h 字段。

异常现象

异常堆栈显示的核心错误信息如下：

java.lang.reflect.InaccessibleObjectException: 
Unable to make field protected java.lang.reflect.InvocationHandler java.lang.reflect.Proxy.h accessible: 
module java.base does not "opens java.lang.reflect" to unnamed module @6aa8e115

这个错误表明 Java 模块系统阻止了对 java.lang.reflect.Proxy 类内部字段的反射访问。

根本原因分析

经过深入排查，发现问题并非直接由 MyBatis-Plus 引起，而是与项目中自定义的拦截器 DataUpdateInterceptor 有关。该拦截器尝试通过反射访问 Statement 对象的内部字段，这在 Java 9 及更高版本的模块系统中受到了严格限制。

关键问题点在于：

1. 拦截器中的 getStatement 方法尝试访问 Proxy 类的内部 h 字段
2. 在 Java 9+ 的模块系统中，java.base 模块默认不开放 java.lang.reflect 包给未命名模块
3. 这种反射访问在项目运行初期可能成功，但随着 JVM 安全策略的严格执行，后期会抛出异常

解决方案

方案一：修改拦截器实现

推荐修改自定义拦截器的实现方式，避免直接访问 JDK 内部类的私有字段。可以：

1. 移除对 Proxy.h 字段的直接访问
2. 使用 MyBatis 提供的工具类 PluginUtils 来安全地获取目标对象
3. 重构 SQL 获取逻辑，不依赖 Statement 对象的字符串表示

示例修改：

public Object intercept(Invocation invocation) {
    StatementHandler statementHandler = PluginUtils.realTarget(invocation.getTarget());
    MetaObject metaObject = SystemMetaObject.forObject(statementHandler);
    // 使用安全的方式获取SQL信息
    // ...
}

方案二：调整 JVM 参数

如果必须保留现有实现，可以添加以下 JVM 参数开放反射权限：

--add-opens java.base/java.lang.reflect=ALL-UNNAMED

但这不是最佳实践，仅作为临时解决方案。

最佳实践建议

1. 避免反射访问 JDK 内部类：这是 Java 模块系统明确禁止的行为
2. 使用官方 API：MyBatis 和 MyBatis-Plus 提供了丰富的工具类和方法
3. 模块化兼容性：确保自定义组件与 Java 模块系统兼容
4. 日志记录优化：考虑使用 MyBatis 内置的日志功能而非拦截 SQL 语句

总结

这个问题很好地展示了 Java 模块系统对反射访问的限制以及如何安全地实现类似功能。作为开发者，我们应该：

1. 理解 Java 模块系统的安全限制
2. 遵循最小权限原则设计拦截器
3. 优先使用框架提供的安全 API
4. 在需要反射时考虑兼容性和安全性

通过重构拦截器实现，不仅可以解决当前问题，还能提高代码的健壮性和未来兼容性。