Apache Shenyu 插件开发中 Base64 类缺失问题的解决方案

问题背景

在基于 Apache Shenyu 2.6.1 版本进行自定义插件开发时，开发者可能会遇到一个常见问题：在继承 shenyu-plugin 和 shenyu-spring-boot-starter-plugin 基础模块后，编译过程中出现 Base64 类找不到的错误。这种情况通常发生在使用 JDK17 进行项目构建时。

问题分析

从技术角度来看，这个问题源于 Apache Shenyu 框架的模块化设计。在 Shenyu 的插件体系中：

1. 核心插件模块 shenyu-plugin-base 提供了基础的插件功能支持
2. 某些工具类（如 Base64）被设计为通过依赖注入方式提供
3. Admin 模块中这些依赖被标记为 provided 作用域，意味着它们不会自动传递到插件模块

解决方案

要解决这个问题，开发者需要在自定义插件的 POM 文件中显式添加 OpenGauss 依赖：

<dependency>
    <groupId>org.opengauss</groupId>
    <artifactId>opengauss-jdbc</artifactId>
    <version>适当版本号</version>
</dependency>

深入理解

1. 模块化设计原则：Shenyu 采用模块化设计，将不同功能解耦，提高灵活性
2. 依赖管理策略：provided 作用域的依赖需要开发者自行管理，确保运行时环境完整
3. JDK 兼容性：不同 JDK 版本对基础类的处理方式可能不同，JDK17 环境下需要特别注意

最佳实践建议

1. 开发自定义插件时，建议先完整分析父模块的依赖结构
2. 遇到类缺失问题时，首先检查是否为 provided 作用域的依赖
3. 保持插件依赖与 Shenyu 核心版本的一致性
4. 在复杂项目中，考虑建立专门的依赖管理模块统一维护公共依赖

总结

Apache Shenyu 作为高性能 API 网关，其插件体系设计既灵活又严谨。理解其模块化设计理念和依赖管理机制，能够帮助开发者更高效地进行插件扩展开发。Base64 类缺失这类问题的解决，不仅是一个具体技术问题的处理，更是对 Shenyu 架构设计思想的一次实践认知。