MyBatis-Plus 兼容 Quarkus 框架的代理类处理方案

背景介绍

MyBatis-Plus 作为 MyBatis 的增强工具，在日常开发中提供了诸多便利功能。但在某些特定框架环境下，如 Quarkus，由于其独特的代理机制，可能导致 MyBatis-Plus 的一些核心功能无法正常工作。本文将深入分析这一问题，并提供完整的解决方案。

问题本质

Quarkus 框架使用了一种不同于传统 Spring 的代理机制，这导致 MyBatis-Plus 在以下场景中可能无法正确识别和处理代理类：

1. 通过 MybatisUtils.getMybatisMapperProxy() 获取代理实现类时
2. 使用 MybatisUtils.extractMapperProxy() 提取原始 Mapper 接口时

技术解决方案

MyBatis-Plus 从 3.5.12 版本开始，引入了 SPI 扩展机制来解决这类框架兼容性问题。核心是通过实现 CompatibleSet 接口来适配不同框架的代理机制。

实现方案一：使用 SPI 扩展机制

1. 创建实现类：

public class QuarkusCompatibleSet implements CompatibleSet {
    
    @Override
    public Object getProxyTargetObject(Object mapper) {
        // Quarkus 特定的代理对象解析逻辑
        if (mapper instanceof io.quarkus.mybatis.runtime.QuarkusMapperProxy) {
            return ((io.quarkus.mybatis.runtime.QuarkusMapperProxy) mapper).getDelegate();
        }
        return mapper;
    }
    
    // 其他方法可根据需要实现
}

2. 在 META-INF/services 目录下创建 SPI 配置文件：

com.baomidou.mybatisplus.core.spi.CompatibleSet

3. 文件内容指定实现类：

com.your.package.QuarkusCompatibleSet

实现方案二：编程式配置

对于需要动态配置的场景，可以直接通过代码设置：

CompatibleHelper.setCompatibleSet(new CompatibleSet() {
    @Override
    public Object getProxyTargetObject(Object mapper) {
        // 实现Quarkus代理对象的解析
        try {
            Field delegateField = mapper.getClass().getDeclaredField("delegate");
            delegateField.setAccessible(true);
            return delegateField.get(mapper);
        } catch (Exception e) {
            return mapper;
        }
    }
});

版本升级建议

建议开发者升级到 MyBatis-Plus 3.5.12 或更高版本以获得最佳的兼容性支持。对于生产环境，可以等待 3.5.12 正式版发布（预计月底），或暂时使用 SNAPSHOT 版本进行开发测试。

最佳实践

1. 代理检测：在实现 getProxyTargetObject 方法时，应先检查对象是否为代理实例，避免不必要的反射操作
2. 异常处理：妥善处理反射可能抛出的异常，确保程序健壮性
3. 性能考虑：对于频繁调用的场景，可缓存反射结果或使用更高效的代理识别方式
4. 多框架兼容：如果需要同时支持多种框架，可以实现优先级判断逻辑

总结

通过 MyBatis-Plus 提供的扩展机制，开发者可以灵活适配各种框架环境下的代理类处理需求。这种设计既保持了核心功能的稳定性，又为特殊场景提供了足够的扩展空间。对于 Quarkus 用户而言，按照本文方案实现后，即可无缝使用 MyBatis-Plus 的各项功能。