All Products
Search

This Product

    Microservices Engine:Java frameworks supported by microservice governance

    Document Center

    Microservices Engine:Java frameworks supported by microservice governance

    Last Updated:Mar 11, 2026

    Microservices Governance in Microservices Engine (MSE) supports multiple Java Development Kit (JDK) versions and Java frameworks. Framework support varies by governance feature. Verify compatibility for each feature you plan to use before you integrate the MSE Java agent.

    Supported JDK versions

    JDK versionRequired MSE agent versionRecommended minimum JDK patch
    JDK 1.8--JDK 8u212 or later (recommended for Kubernetes deployments)
    JDK 112.9.xJDK 11.0.17 or later
    JDK 172.9.xJDK 17.0.9 or later
    JDK 213.2.x--

    Supported JDK distributions

    DistributionStatus
    OpenJDKRecommended
    Alibaba DragonwellRecommended
    TemurinSupported
    AdoptOpenJDKSupported
    Amazon CorrettoSupported
    AzulSupported
    Java HotSpot VMSupported
    Important

    Eclipse OpenJ9 is incompatible with MSE Microservices Governance. We recommend that you do not use Eclipse OpenJ9 when you use Microservices Governance.

    Supported frameworks by governance feature

    Not all frameworks support every governance feature. Use the feature-specific tables in this section to check compatibility for your use case.

    Traffic protection and metric monitoring

    CategoryFrameworkSupported versions
    WebSpring MVCAssociated Spring Cloud versions
    WebSpring Boot2.x.x to 3.2.3
    WebSpring CloudE, F, G, H, 2020.x, 2021.x, 2022.x, 2023.x
    WebFeignAssociated Spring Cloud versions
    Java gatewaySpring Cloud Zuul1.3.x to 2.1.3
    Java gatewaySpring Cloud Gateway2.0.2 to 4.1.0
    RPCDubbo2.7.x, 3.0.x, 3.1.x, 3.2.x

    End-to-end canary release

    CategoryFrameworkSupported versions
    SpringSpring Boot2.x.x to 3.2.3
    SpringSpring CloudE, F, G, H, 2020.x, 2021.x, 2022.x, 2023.x
    Java gatewaySpring Cloud Zuul1.3.x to 2.1.3
    Java gatewaySpring Cloud Gateway2.1.x to 4.1.0
    Load balancerSpring Cloud LoadBalancerAssociated Spring Cloud versions
    Load balancerRibbonAssociated Spring Cloud versions
    RegistryNacosAssociated Spring Cloud versions
    RegistryEurekaSupported
    RegistryZooKeeperSupported
    RPCDubbo2.7.x, 3.0.x, 3.1.x, 3.2.x
    Web serverTomcat7.x to 10.x
    Web serverUndertow1.4.x to 2.2.x
    MessagingRocketMQ4.x
    MessagingRocketMQ ONS1.x and later
    HTTP client (public preview)RestTemplateAssociated Spring versions
    HTTP client (public preview)WebClientAssociated Spring versions
    HTTP client (public preview)FeignAssociated Spring Cloud versions
    HTTP client (public preview)OkHttp2.2.x to 2.7.x, 3.2.x to 4.12.x
    HTTP client (public preview)Apache HttpClient4.3.x to 4.5.x, 5.0.x to 5.4.x
    Note

    End-to-end canary release based on Kubernetes services with an HTTP client is in public preview. This feature requires Java agent version 4.2.5-proxyless. For details, see Specify the agent version. If you have questions, submit a ticket.

    Graceful start and shutdown

    CategoryFrameworkSupported versions
    SpringSpring Boot2.x.x to 3.2.3
    SpringSpring CloudE, F, G, H, 2020.x, 2021.x, 2022.x, 2023.x
    Java gatewaySpring Cloud Zuul1.3.x to 2.1.3
    Java gatewaySpring Cloud Gateway2.1.x to 4.1.0
    RegistryNacosAssociated Spring Cloud versions
    RegistryEurekaSupported
    RegistryZooKeeperSupported
    RPCDubbo2.7.x, 3.0.x, 3.1.x, 3.2.x

    Framework support comparison across features

    The following table summarizes which framework categories each governance feature supports. Use this table to quickly identify whether a framework category is available for your target feature.

    Framework categoryTraffic protectionEnd-to-end canary releaseGraceful start and shutdown
    Spring Boot / Spring CloudYesYesYes
    Spring Cloud ZuulYesYesYes
    Spring Cloud GatewayYesYesYes
    DubboYesYesYes
    Load balancer (Ribbon, Spring Cloud LoadBalancer)--Yes--
    Registry (Nacos, Eureka, ZooKeeper)--YesYes
    Web server (Tomcat, Undertow)--Yes--
    Messaging (RocketMQ)--Yes--
    HTTP client (public preview)--Yes--