金祥 杨
Creator of LingFrame & LingMirror | Apache SeaTunnel Community Member | JVM Runtime Governance
Actions
Jinxiang Yang is the creator of LingFrame (灵珑), an open source runtime governance framework for long-lived JVM single-process systems, and LingMirror (灵镜), an IntelliJ IDEA plugin for static ClassLoader leak diagnosis. Focused on the governance of long-running JVM systems, he identified critical ClassLoader lifecycle gaps in Apache SeaTunnel through deep source code analysis, and proposed a systematic governance improvement plan that has been actively discussed in the SeaTunnel community. He believes a system is not complete when it runs — it is complete when its lifecycle can be observed, governed, and proven correct over time.
From Governance Vacuum to Verifiable Closed Loop: ClassLoader Leak in Long-Running JVM
Long-running JVM systems pervasively face the structural dilemma of ClassLoader leaks. From JDBC driver registrations to ThreadLocal escapes, these subtle patterns are difficult to inspect during development and manifest as Metaspace OOM at runtime. Fundamentally, this stems from a lack of explicit unloading semantics and resource ownership constraints—a state of “governance vacuum.”
While advancing governance efforts in the Apache SeaTunnel community, we encountered a classic impasse: even though the necessity of a resource release mechanism had been confirmed in discussions (#10669), the Phase 1 implementation PR was repeatedly stalled due to the absence of quantifiable verification methods. This proved a critical point: governance without verification cannot land in complex open-source systems.
To break this deadlock, we built a complete closed loop from runtime governance to development-time verification:
Runtime Governance Engine (LingFrame): Serving as the starting point of all governance, it establishes explicit resource reclamation mechanisms and verifiable unloading semantics through a two-tier state machine and an exclusive write permission model. It solves the fundamental engineering problem of how to safely load and unload dynamic modules.
Static Verification Tool (LingMirror): An IntelliJ IDEA plugin that provides reference chain visualization for 18 real-world leak patterns, shifting governance verification from post-mortem runtime analysis to real-time development detection. This tool has been cross-validated across several top-tier open-source projects, identifying over 150 risk points cumulatively.
This session will share the practical journey from problem definition and community negotiation to the establishment of a verifiable governance closed loop. We aim to drive industry attention toward the full lifecycle of ClassLoaders—shifting focus from merely loading to comprehensive lifecycle governance—and help complex systems evolve from "too risky to touch" to "confidently evolvable."
From "Usable" to "Governable": ClassLoader Lifecycle Governance Practice in Apache SeaTunnel
ClassLoader leaks are among the most hidden and difficult-to-diagnose runtime problems in long-lived JVM systems, and a common challenge faced by long-running JVM workloads across the Apache ecosystem. Existing approaches largely remain at the "post-mortem investigation" stage: monitoring tools and heap dumps can tell developers "which ClassLoaders are still alive," but struggle to clearly explain "why they cannot be reclaimed," let alone translate governance intent into verifiable, reproducible engineering practices.
Through deep analysis of Apache SeaTunnel's classloading mechanism, we identified a widely overlooked blind spot: a large number of seemingly correct lifecycle implementations never establish explicit resource-close semantics. Without enforced close and drain constraints, resource reclamation becomes highly unpredictable — and in certain scenarios, leads to ClassLoaders that can never be collected.
Drawing on our exploration of runtime governance for long-lived JVM systems, we proposed a systematic ClassLoader lifecycle governance improvement plan to the Apache SeaTunnel community. The core shift is from passive "post-hoc residual reference hunting" to proactive "building deterministic reclaimable semantics and lifecycle closure." We incrementally introduced explicit lifecycle close mechanisms, enforced classloading boundary constraints, and active residual reference cleanup. The governance proposal is currently under community discussion, with the Phase 1 optimization PR in review.
This talk will explore real-world community practices in Apache SeaTunnel, covering:
1. Why long-lived systems cannot rely on implicit GC to manage underlying runtime resources
2. How to build a ClassLoader governance standard for long-lived JVM systems and progressively land it in Apache open source projects
3. How to complete a smooth, kernel-level architectural governance upgrade without breaking compatibility
Community Over Code Asia 2026 Sessionize Event Upcoming
金祥 杨
Creator of LingFrame & LingMirror | Apache SeaTunnel Community Member | JVM Runtime Governance
Actions
Please note that Sessionize is not responsible for the accuracy or validity of the data provided by speakers. If you suspect this profile to be fake or spam, please let us know.
Jump to top