Spring Cloud Alibaba


Spring Cloud Alibaba provides a one-stop solution for distributed application development. It contains all the components required to develop distributed applications, making it easy for you to develop your applications using Spring Cloud.

With Spring Cloud Alibaba, you only need to add some annotations and a small amount of configurations to connect Spring Cloud applications to the distributed solutions of Alibaba, and build a distributed application system with Alibaba middleware.


  • Flow control and service degradation:flow control, circuit breaking and system adaptive protection with Sentinel.

  • Service registration and discovery:instances can be registered with Nacos and clients can discover the instances using Spring-managed beans. Supports Ribbon, the client side load-balancer via Spring Cloud Netflix.

  • Distributed Configuration:using Nacos as a data store

  • Event-driven:building highly scalable event-driven microservices connected with Spring Cloud Stream RocketMQ Binder

  • Message Bus: link nodes of a distributed system with Spring Cloud Bus RocketMQ

  • Distributed Transaction:support for distributed transaction solution with high performance and ease of use with Seata

  • Dubbo RPC:extend the communication protocols of Spring Cloud service-to-service calls by Dubbo RPC

  • Alibaba Cloud Object Storage:Spring Resource Abstraction for OSS. Alibaba Cloud Object Storage Service (OSS) is an encrypted, secure, cost-effective, and easy-to-use object storage service that enables you to store, back up, and archive large amounts of data in the cloud

Getting Started

The easiest way to get started is by including the Spring Cloud BOM and then adding spring-cloud-alibaba-dependencies to your application’s classpath. If you don’t want to include all of the Spring Cloud Alibaba features you can add individual starters for the features you would like.

The spring-cloud-alibaba-dependencies dependency in pom:


​ The Spring Cloud Alibaba & Spring Cloud & Spring Boot compatibility table: ​

Spring Cloud Version

Spring Cloud Alibaba Version

Spring Boot Version




Spring Cloud Greenwich



Spring Cloud Finchley



Spring Cloud Edgware



As long as Spring Cloud Alibaba Nacos and the Nacos API are on the classpath any Spring Boot application with @EnableDiscoveryClient will try to contact a Nacos Server on localhost:8848 (the default value of ​

public class Application {
  public String home() {
    return "Hello World";
  public static void main(String[] args) {, args);

A local Nacos server must be running. See the Nacos documentation on how to run a Nacos server.

Spring Initializr

Quickstart Your Project

Bootstrap your application with Spring Initializr.


Each Spring project has its own; it explains in great details how you can use project features and what you can achieve with them.
2.1.0 CURRENT GA Reference Doc. API Doc.
2.0.0 GA Reference Doc. API Doc.
1.5.0 GA Reference Doc. API Doc.