灵元 Ling
一个可独立加载、运行、治理与卸载的业务 JAR。
独立 ClassLoader 隔离私有依赖,通过明确的契约与宿主交互。支持 Spring Boot 业务模块,也支持不启动 Spring 容器的 Native Java 模块。
业务边界,不只是代码目录。
不推翻存量系统,也不把每次变更都变成应用重启。
以业务模块为单位,让装卸、灰度、调用治理与回收
在同一个 JVM 内形成闭环。
路由 · 限流 · 舱壁 · 权限 · 审计
基线版本
金丝雀版本
外部平台管理服务之间。灵珑管理 JVM 之内。
两者协同,不必二选一。
灵珑(LingFrame)是一个开源(Apache-2.0)的 JVM 进程内运行时治理框架:以独立业务 JAR(灵元)为边界,让长期运行的 JVM 系统可以按模块装卸、多版本灰度,并通过统一的调用治理与可观测回收,在不推翻存量系统、不必把每次变更都变成应用重启的前提下持续演进。
一个可独立加载、运行、治理与卸载的业务 JAR。
独立 ClassLoader 隔离私有依赖,通过明确的契约与宿主交互。支持 Spring Boot 业务模块,也支持不启动 Spring 容器的 Native Java 模块。
业务边界,不只是代码目录。
部署调度、网络路由、容量伸缩、实例级滚动更新。
模块装卸、权重灰度、调用治理、生命周期与回收观察。
把一次整体替换,拆成一组可观察、可调整的步骤。
用流量权重逐步放量,用生命周期管理有序退出。
保留基线实现,独立加载新版本。
v1 + v2从小比例开始,按权重路由请求。
weighted routing检查调用、异常与运行时信号。
observe & decide停止分配新流量,等待在途完成。
awaitIdle完成资源清理,观察回收。
unload → observe灰度异常时先收回流量权重;类加载器实际回收仍取决于引用释放与 JVM GC。
适合需要长期运行、又希望局部持续变化的 JVM 应用。
保留稳定入口与默认实现,让新的业务模块先独立运行,再逐步接管流量。
让规则、连接器或业务扩展按自己的节奏发布,而不是绑定整套应用的发布节奏。
不仅关注“能加载”,也关注退出时的在途请求、资源引用与类加载器回收结果。
把测试范围、观察结果和未解决的问题放在一起。
先看公开证据,再判断是否适合你的负载。
目标 Job ClassLoader 残留
仅指本次测试 GC 后的目标加载器存活数,不代表所有运行场景。
阅读发布 PR 与测试结果COUNT由 14 扩展至 15,新增 MongoDB → Hive
发布 PR 报告的端到端测试结果
长期 Metaspace 收敛仍需继续验证。一次回收通过,不等于任何负载下都无泄漏。
更早的 144 个交错作业、96.3% 类卸载率与 14.06 MB Metaspace 增量属于另一组实验。这些结果不作为当前测试指标,也不表示 144 个作业同时并发。
查看历史验证报告RuoYi 示例仓库展示了从现有单体向灵元边界演进的工程路径。它是参考实现,不是对任意业务“零改造”的承诺。
查看 RuoYi 改造示例7 月 9 日空业务 JMH 平均耗时:仅治理约 0.8 µs,含终端调用约 19 µs。非 p95,非 v0.4.7 实测;实际负载需压测。
查看基准模块与复现说明先用官方示例熟悉装卸与治理流程,再验证自己的业务。
默认环境为 JDK 8 + Spring Boot 2.7,需要 Maven。
克隆仓库并进入项目目录。
运行示例灵核,观察灵元加载与路由。
用真实依赖、线程与数据源,检查模块装卸和资源释放。
# 01 获取项目
git clone https://github.com/LingFrame/LingFrame.git
cd LingFrame
# 02 构建示例灵核
mvn -pl lingframe-examples/lingframe-example-lingcore-app -am package -DskipTests
# 03 启动
cd lingframe-examples/lingframe-example-lingcore-app
mvn spring-boot:runhttp://localhost:8888/dashboard.html灵珑(LingFrame)是一个开源(Apache-2.0)的 JVM 进程内运行时治理框架,面向需要长期运行、又希望局部持续变化的 JVM 应用。它以独立业务 JAR(灵元 Ling)为边界,把模块装卸、多版本灰度、调用治理与可观测回收放在同一个 JVM 内形成闭环。
不是替代品,两者协同,不必二选一。K8s、网关、Service Mesh 管理进程之间:部署调度、网络路由、容量伸缩与实例级滚动更新;灵珑管理进程之内:模块装卸、权重灰度、调用治理、生命周期与回收观察。灵珑不承担跨进程网络通信、集群调度或节点容灾。
灵元是一个可独立加载、运行、治理与卸载的业务 JAR,用独立 ClassLoader 隔离私有依赖,并通过明确的契约与宿主交互。灵核(LingCore)是承载灵元的宿主应用。
默认环境是 Spring Boot 2.7 加 JDK 8,同时支持 Spring Boot 3.5 加 JDK 17,构建需要 Maven。灵元既可以是 Spring Boot 业务模块,也可以是不启动 Spring 容器的 Native Java 模块。
最快的方式是运行官方示例:克隆仓库,构建并启动示例灵核,然后访问 http://localhost:8888/dashboard.html 观察灵元加载与路由。也可以先打开在线演示控制面 dashboard.lingframe.cn(公开演示令牌为 lingframe)熟悉操作,接入前仍需在本地用自己的业务验证。
7 月 9 日空业务 JMH 平均耗时:仅治理约 0.8 µs,含终端调用约 19 µs。非 p95,非 v0.4.7 实测;实际负载需压测。
v0.4.7 仍处于 Pre-1.0。请先在测试环境验证真实业务负载、依赖与资源释放,再对照生产硬化清单检查鉴权、配置与观测。
不能。已加载到共享边界的契约不支持热更新或热卸载,以保持跨 ClassLoader 的类型一致性。可以预加载新的契约包;已有契约的破坏性变更仍需要重启进程。
不是。卸载流程负责停止路由、排空、关闭上下文并释放引用;类加载器和类元数据的实际回收还取决于残留引用与 JVM GC。需要结合观测验证,而不是只看卸载状态。
不是。托管数据源治理主要覆盖经 Spring 注入的 DataSource,手工创建的原生 JDBC 连接不在相同拦截边界内。请按文档核验资源归属与事务传播。
不必。Dashboard 是选配模块,需要显式开启。也可以使用配置或 Actuator 进行管控。生产环境开启鉴权时应配置专用访问令牌,不要沿用公开演示令牌。