JVM 进程内运行时治理框架

让长期运行的
JVM 系统,
按模块持续演进。

不推翻存量系统,也不把每次变更都变成应用重启。
以业务模块为单位,让装卸、灰度、调用治理与回收
在同一个 JVM 内形成闭环。

v0.4.7 · 含章Pre-1.02026.09.26
业务 JAR 独立装卸多版本渐进切流回收结果可观测
长期运行的 JVM

宿主应用 / LingCore

Shared API:已加载契约保持冻结

调用治理

路由 · 限流 · 舱壁 · 权限 · 审计

Ling v1 85%

基线版本

Ling v2 15%

金丝雀版本

预检 → 排空 → 卸载观察类加载器回收
独立 ClassLoader 隔离。85% / 15% 为示例流量权重,非实时运行数据。
默认 Spring Boot 2.7 / JDK 8支持 Spring Boot 3.5 / JDK 17Apache-2.0 开源
01 / 定义与定位

管好进程内部,
让每次改变更可控。

外部平台管理服务之间。灵珑管理 JVM 之内。
两者协同,不必二选一。

灵珑(LingFrame)是一个开源(Apache-2.0)的 JVM 进程内运行时治理框架:以独立业务 JAR(灵元)为边界,让长期运行的 JVM 系统可以按模块装卸、多版本灰度,并通过统一的调用治理与可观测回收,在不推翻存量系统、不必把每次变更都变成应用重启的前提下持续演进。

灵元 Ling

一个可独立加载、运行、治理与卸载的业务 JAR。

独立 ClassLoader 隔离私有依赖,通过明确的契约与宿主交互。支持 Spring Boot 业务模块,也支持不启动 Spring 容器的 Native Java 模块。

业务边界,不只是代码目录。

进程之间

K8s / 网关 / Service Mesh

部署调度、网络路由、容量伸缩、实例级滚动更新。

进程之内

LingFrame

模块装卸、权重灰度、调用治理、生命周期与回收观察。

02 / 演进路径

先共存,再放量。
验证之后,再退出旧版本。

把一次整体替换,拆成一组可观察、可调整的步骤。
用流量权重逐步放量,用生命周期管理有序退出。

01

共存

保留基线实现,独立加载新版本。

v1 + v2
02

灰度

从小比例开始,按权重路由请求。

weighted routing
03

观察

检查调用、异常与运行时信号。

observe & decide
04

排空

停止分配新流量,等待在途完成。

awaitIdle
05

卸载

完成资源清理,观察回收。

unload → observe

灰度异常时先收回流量权重;类加载器实际回收仍取决于引用释放与 JVM GC。

03 / 适用场景

有边界地拆分。
有退路地演进。

适合需要长期运行、又希望局部持续变化的 JVM 应用。

存量单体,渐进拆分

保留稳定入口与默认实现,让新的业务模块先独立运行,再逐步接管流量。

从一个边界清晰的模块开始

扩展能力,独立迭代

让规则、连接器或业务扩展按自己的节奏发布,而不是绑定整套应用的发布节奏。

Spring Boot / Native Java

长时进程,重视回收

不仅关注“能加载”,也关注退出时的在途请求、资源引用与类加载器回收结果。

把退出也纳入生命周期
04 / 公开验证

不仅要能加载。
还要验证能否退出。

把测试范围、观察结果和未解决的问题放在一起。
先看公开证据,再判断是否适合你的负载。

SeaTunnel Agent · v0.3.1

本次测试 GC 后,目标加载器残留为 0。

0

目标 Job ClassLoader 残留

仅指本次测试 GC 后的目标加载器存活数,不代表所有运行场景。

阅读发布 PR 与测试结果
目标 Job ClassLoader 残留COUNT
Agent 组0
对照组567
15场景覆盖

由 14 扩展至 15,新增 MongoDB → Hive

12E2E 通过

发布 PR 报告的端到端测试结果

最终 Metaspace90.47 MiB

90.47 MiB 是最终占用,不是增长量。

长期 Metaspace 收敛仍需继续验证。一次回收通过,不等于任何负载下都无泄漏。

历史报告单独保留,不与本次指标混用

更早的 144 个交错作业、96.3% 类卸载率与 14.06 MB Metaspace 增量属于另一组实验。这些结果不作为当前测试指标,也不表示 144 个作业同时并发。

查看历史验证报告
Migration / RuoYi

从改造示例,了解接入路径。

RuoYi 示例仓库展示了从现有单体向灵元边界演进的工程路径。它是参考实现,不是对任意业务“零改造”的承诺。

查看 RuoYi 改造示例
Historical microbenchmark / JMH

微基准提供参考,真实负载仍需压测。

7 月 9 日空业务 JMH 平均耗时:仅治理约 0.8 µs,含终端调用约 19 µs。非 p95,非 v0.4.7 实测;实际负载需压测。

查看基准模块与复现说明
05 / 开始评估

先跑通一个模块。
再评估下一步。

先用官方示例熟悉装卸与治理流程,再验证自己的业务。
默认环境为 JDK 8 + Spring Boot 2.7,需要 Maven。

  1. 1

    获取项目

    克隆仓库并进入项目目录。

  2. 2

    构建与启动

    运行示例灵核,观察灵元加载与路由。

  3. 3

    验证实际业务

    用真实依赖、线程与数据源,检查模块装卸和资源释放。

阅读完整快速开始
运行官方示例
# 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:run
启动后访问 http://localhost:8888/dashboard.html
灵珑是什么?

灵珑(LingFrame)是一个开源(Apache-2.0)的 JVM 进程内运行时治理框架,面向需要长期运行、又希望局部持续变化的 JVM 应用。它以独立业务 JAR(灵元 Ling)为边界,把模块装卸、多版本灰度、调用治理与可观测回收放在同一个 JVM 内形成闭环。

灵珑和微服务、K8s 是什么关系?是替代品吗?

不是替代品,两者协同,不必二选一。K8s、网关、Service Mesh 管理进程之间:部署调度、网络路由、容量伸缩与实例级滚动更新;灵珑管理进程之内:模块装卸、权重灰度、调用治理、生命周期与回收观察。灵珑不承担跨进程网络通信、集群调度或节点容灾。

灵元(Ling)和灵核(LingCore)分别是什么?

灵元是一个可独立加载、运行、治理与卸载的业务 JAR,用独立 ClassLoader 隔离私有依赖,并通过明确的契约与宿主交互。灵核(LingCore)是承载灵元的宿主应用。

灵珑支持哪些 JDK 和 Spring Boot 版本?

默认环境是 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。请先在测试环境验证真实业务负载、依赖与资源释放,再对照生产硬化清单检查鉴权、配置与观测。

Shared API 可以跟着灵元一起热更新吗?

不能。已加载到共享边界的契约不支持热更新或热卸载,以保持跨 ClassLoader 的类型一致性。可以预加载新的契约包;已有契约的破坏性变更仍需要重启进程。

卸载完成,是否意味着内存立即下降?

不是。卸载流程负责停止路由、排空、关闭上下文并释放引用;类加载器和类元数据的实际回收还取决于残留引用与 JVM GC。需要结合观测验证,而不是只看卸载状态。

所有 JDBC 调用都受到数据源治理吗?

不是。托管数据源治理主要覆盖经 Spring 注入的 DataSource,手工创建的原生 JDBC 连接不在相同拦截边界内。请按文档核验资源归属与事务传播。

必须启用 Dashboard 吗?

不必。Dashboard 是选配模块,需要显式开启。也可以使用配置或 Actuator 进行管控。生产环境开启鉴权时应配置专用访问令牌,不要沿用公开演示令牌。