{"id":13458823,"url":"https://github.com/alibaba/spring-cloud-alibaba","last_synced_at":"2026-01-06T12:10:17.107Z","repository":{"id":37359128,"uuid":"112785414","full_name":"alibaba/spring-cloud-alibaba","owner":"alibaba","description":"Spring Cloud Alibaba provides a one-stop solution for application development for the distributed solutions of Alibaba middleware.","archived":false,"fork":false,"pushed_at":"2024-12-04T01:22:42.000Z","size":55608,"stargazers_count":28443,"open_issues_count":265,"forks_count":8408,"subscribers_count":965,"default_branch":"2023.x","last_synced_at":"2025-05-05T14:09:43.983Z","etag":null,"topics":["alibaba","alibaba-middleware","alibaba-oss","aliyun","circuit-breaker","cloud-native","distributed-configuration","distributed-messaging","distributed-transaction","dubbo","java","microservices","nacos","rocketmq","service-discovery","service-registry","spring","spring-cloud","spring-cloud-alibaba","spring-cloud-core"],"latest_commit_sha":null,"homepage":"https://sca.aliyun.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alibaba.png","metadata":{"files":{"readme":"README-zh.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"Roadmap-zh.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-01T20:49:15.000Z","updated_at":"2025-05-04T14:08:49.000Z","dependencies_parsed_at":"2023-10-13T11:09:42.008Z","dependency_job_id":"d7d04d6c-1bf2-4e9f-86c1-b24d0005edee","html_url":"https://github.com/alibaba/spring-cloud-alibaba","commit_stats":{"total_commits":1802,"total_committers":219,"mean_commits":8.228310502283104,"dds":0.8462819089900111,"last_synced_commit":"bd288a81771869751baeead54155a66ca6bd1622"},"previous_names":["spring-cloud-incubator/spring-cloud-alibaba"],"tags_count":56,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fspring-cloud-alibaba","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fspring-cloud-alibaba/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fspring-cloud-alibaba/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fspring-cloud-alibaba/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alibaba","download_url":"https://codeload.github.com/alibaba/spring-cloud-alibaba/tar.gz/refs/heads/2023.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252550582,"owners_count":21766571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alibaba","alibaba-middleware","alibaba-oss","aliyun","circuit-breaker","cloud-native","distributed-configuration","distributed-messaging","distributed-transaction","dubbo","java","microservices","nacos","rocketmq","service-discovery","service-registry","spring","spring-cloud","spring-cloud-alibaba","spring-cloud-core"],"created_at":"2024-07-31T09:00:57.830Z","updated_at":"2026-01-06T12:10:17.040Z","avatar_url":"https://github.com/alibaba.png","language":"Java","readme":"# Spring Cloud Alibaba\n\n[![CircleCI](https://circleci.com/gh/alibaba/spring-cloud-alibaba/tree/2023.x.svg?style=svg)](https://circleci.com/gh/alibaba/spring-cloud-alibaba/tree/2023.x)\n[![Maven Central](https://img.shields.io/maven-central/v/com.alibaba.cloud/spring-cloud-alibaba-dependencies.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:com.alibaba.cloud%20AND%20a:spring-cloud-alibaba-dependencies)\n[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)\n[![actions](https://github.com/alibaba/spring-cloud-alibaba/workflows/Integration%20Testing/badge.svg)](https://github.com/alibaba/spring-cloud-alibaba/actions)\n[![Leaderboard](https://img.shields.io/badge/SCA-Check%20Your%20Contribution-orange)](https://opensource.alibaba.com/contribution_leaderboard/details?projectValue=sca)\n\nSpring Cloud Alibaba 致力于提供微服务开发的一站式解决方案。此项目包含开发分布式应用微服务的必需组件，方便开发者通过 Spring Cloud 编程模型轻松使用这些组件来开发分布式应用服务。\n\n依托 Spring Cloud Alibaba，您只需要添加一些注解和少量配置，就可以将 Spring Cloud 应用接入阿里微服务解决方案，通过阿里中间件来迅速搭建分布式应用系统。\n\n此外，阿里云同时还提供了 Spring Cloud Alibaba 企业版 [微服务解决方案](https://www.aliyun.com/product/aliware/mse?spm=github.spring.com.topbar)，包括无侵入服务治理(全链路灰度，无损上下线，离群实例摘除等)，企业级 Nacos 注册配置中心和企业级云原生网关等众多产品。\n\n参考文档 请查看 [WIKI](https://github.com/alibaba/spring-cloud-alibaba/wiki) 。\n\n为 Spring Cloud Alibaba 贡献代码请参考 [如何贡献](https://sca.aliyun.com/docs/developer/contributor-guide/new-contributor-guide_dev/) 。\n\n## 主要功能\n\n* **服务限流降级**：默认支持 WebServlet、WebFlux、OpenFeign、RestTemplate、Spring Cloud Gateway、Dubbo 和 RocketMQ 限流降级功能的接入，可以在运行时通过控制台实时修改限流降级规则，还支持查看限流降级 Metrics 监控。\n* **服务注册与发现**：适配 Spring Cloud 服务注册与发现标准，默认集成对应 Spring Cloud 版本所支持的负载均衡组件的适配。\n* **分布式配置管理**：支持分布式系统中的外部化配置，配置更改时自动刷新。\n* **消息驱动能力**：基于 Spring Cloud Stream 为微服务应用构建消息驱动能力。\n* **分布式事务**：使用 @GlobalTransactional 注解， 高效并且对业务零侵入地解决分布式事务问题。\n* **阿里云对象存储**：阿里云提供的海量、安全、低成本、高可靠的云存储服务。支持在任何应用、任何时间、任何地点存储和访问任意类型的数据。\n* **分布式任务调度**：提供秒级、精准、高可靠、高可用的定时（基于 Cron 表达式）任务调度服务。同时提供分布式的任务执行模型，如网格任务。网格任务支持海量子任务均匀分配到所有 Worker（schedulerx-client）上执行。\n* **阿里云短信服务**：覆盖全球的短信服务，友好、高效、智能的互联化通讯能力，帮助企业迅速搭建客户触达通道。\n\n\n更多功能请参考 [Roadmap](https://github.com/alibaba/spring-cloud-alibaba/blob/2023.x/Roadmap-zh.md)\n\n除了上述所具有的功能外，针对企业级用户的场景，Spring Cloud Alibaba 配套的企业版微服务治理方案 [微服务引擎MSE](https://www.aliyun.com/product/aliware/mse?spm=github.spring.com.topbar) 还提供了企业级微服务治理中心，包括全链路灰度、服务预热、无损上下线和离群实例摘除等更多更强大的治理能力，同时还提供了企业级 Nacos 注册配置中心，企业级云原生网关等多种产品及解决方案。\n\n## 组件\n\n**[Sentinel](https://github.com/alibaba/Sentinel)**：把流量作为切入点，从流量控制、熔断降级、系统负载保护等多个维度保护服务的稳定性。\n\n**[Nacos](https://github.com/alibaba/Nacos)**：一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。\n\n**[RocketMQ](https://rocketmq.apache.org/)**：一款开源的分布式消息系统，基于高可用分布式集群技术，提供低延时的、高可靠的消息发布与订阅服务。\n\n**[Seata](https://github.com/seata/seata)**：阿里巴巴开源产品，一个易于使用的高性能微服务分布式事务解决方案。\n\n**[Alibaba Cloud OSS](https://www.aliyun.com/product/oss)**: 阿里云对象存储服务（Object Storage Service，简称 OSS），是阿里云提供的海量、安全、低成本、高可靠的云存储服务。您可以在任何应用、任何时间、任何地点存储和访问任意类型的数据。\n\n**[Alibaba Cloud SchedulerX](https://cn.aliyun.com/aliware/schedulerx)**: 阿里中间件团队开发的一款分布式任务调度产品，提供秒级、精准、高可靠、高可用的定时（基于 Cron 表达式）任务调度服务。\n\n**[Alibaba Cloud SMS](https://www.aliyun.com/product/sms)**: 覆盖全球的短信服务，友好、高效、智能的互联化通讯能力，帮助企业迅速搭建客户触达通道。\n\n更多组件请参考 [Roadmap](https://github.com/alibaba/spring-cloud-alibaba/blob/2023.x/Roadmap-zh.md)。\n\n## 如何构建\n* 2023.x 分支对应的是 Spring Cloud 2023 与 Spring Boot 3.2.x，最低支持 JDK 17。\n* 2022.x 分支对应的是 Spring Cloud 2022 与 Spring Boot 3.0.x，最低支持 JDK 17。\n* 2021.x 分支对应的是 Spring Cloud 2021 与 Spring Boot 2.6.x，最低支持 JDK 1.8。\n* 2020.0 分支对应的是 Spring Cloud 2020 与 Spring Boot 2.4.x，最低支持 JDK 1.8。\n* 2.2.x 分支对应的是 Spring Cloud Hoxton 与 Spring Boot 2.2.x，最低支持 JDK 1.8。\n* greenwich 分支对应的是 Spring Cloud Greenwich 与 Spring Boot 2.1.x，最低支持 JDK 1.8。\n* finchley 分支对应的是 Spring Cloud Finchley 与 Spring Boot 2.0.x，最低支持 JDK 1.8。\n* 1.x 分支对应的是 Spring Cloud Edgware 与 Spring Boot 1.x，最低支持 JDK 1.7。\n\nSpring Cloud 使用 Maven 来构建，最快的使用方式是将本项目 clone 到本地，然后执行以下命令：\n```bash\n./mvnw install\n```\n执行完毕后，项目将被安装到本地 Maven 仓库。\n\n## 如何使用\n\n### 如何引入依赖\n\n如果需要使用已发布的版本，在 `dependencyManagement` 中添加如下配置。\n```xml\n\u003cdependencyManagement\u003e\n    \u003cdependencies\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003ecom.alibaba.cloud\u003c/groupId\u003e\n            \u003cartifactId\u003espring-cloud-alibaba-dependencies\u003c/artifactId\u003e\n            \u003cversion\u003e2023.0.1.0\u003c/version\u003e\n            \u003ctype\u003epom\u003c/type\u003e\n            \u003cscope\u003eimport\u003c/scope\u003e\n        \u003c/dependency\u003e\n    \u003c/dependencies\u003e\n\u003c/dependencyManagement\u003e\n```\n然后在 `dependencies` 中添加自己所需使用的依赖即可使用。如果你想选择老版本，可以参考[版本说明](https://github.com/alibaba/spring-cloud-alibaba/wiki/%E7%89%88%E6%9C%AC%E8%AF%B4%E6%98%8E)。\n\n## 演示 Demo\n\n为了演示如何使用，Spring Cloud Alibaba 项目包含了一个子模块`spring-cloud-alibaba-examples`。此模块中提供了演示用的 example ，您可以阅读对应的 example 工程下的 readme 文档，根据里面的步骤来体验。\n\nExample 列表：\n\n[Sentinel Example](https://github.com/alibaba/spring-cloud-alibaba/tree/2023.x/spring-cloud-alibaba-examples/sentinel-example/sentinel-core-example/readme-zh.md)\n\n[Nacos Example](https://github.com/alibaba/spring-cloud-alibaba/blob/2023.x/spring-cloud-alibaba-examples/nacos-example/readme-zh.md)\n\n[RocketMQ Example](https://github.com/alibaba/spring-cloud-alibaba/blob/2023.x/spring-cloud-alibaba-examples/rocketmq-example/readme-zh.md)\n\n[Seata Example](https://github.com/alibaba/spring-cloud-alibaba/blob/2023.x/spring-cloud-alibaba-examples/seata-example/readme-zh.md)\n\n[Alibaba Cloud OSS Example](https://github.com/alibaba/aliyun-spring-boot/tree/master/aliyun-spring-boot-samples/aliyun-oss-spring-boot-sample)\n\n[Alibaba Cloud SMS Example](https://github.com/alibaba/aliyun-spring-boot/tree/master/aliyun-spring-boot-samples/aliyun-sms-spring-boot-sample)\n\n[Alibaba Cloud SchedulerX Example](https://github.com/alibaba/aliyun-spring-boot)\n\n## 版本管理规范\n\n项目的版本号格式为 x.x.x 的形式，其中 x 的数值类型为数字，从 0 开始取值，且不限于 0~9 这个范围。项目处于孵化器阶段时，第一位版本号固定使用 0，即版本号为 0.x.x 的格式。\n\n由于 Spring Boot 1 和 Spring Boot 2 在 Actuator 模块的接口和注解有很大的变更，且 spring-cloud-commons 从 1.x.x 版本升级到 2.0.0 版本也有较大的变更，因此我们采取跟 SpringBoot 版本号一致的版本:\n\n* 1.5.x 版本适用于 Spring Boot 1.5.x\n* 2.0.x 版本适用于 Spring Boot 2.0.x\n* 2.1.x 版本适用于 Spring Boot 2.1.x\n* 2.2.x 版本适用于 Spring Boot 2.2.x\n* 2020.x 版本适用于 Spring Boot 2.4.x\n* 2021.x 版本适用于 Spring Boot 2.6.x\n* 2022.x 版本适用于 Spring Boot 3.0.x\n* 2023.x 版本适用于 Spring Boot 3.2.x\n\n## 社区交流\n\n### 邮件列表\n\nspring-cloud-alibaba@googlegroups.com，欢迎通过此邮件列表讨论与 spring-cloud-alibaba 相关的一切。\n\n### 钉钉群\n\n* Spring Cloud Alibaba 开源交流群（1群）：21914947\n* Spring Cloud Alibaba 开源交流群（2群，已满）：21992595\n* Spring Cloud Alibaba 开源交流群（3群，已满）：35153903\n* Spring Cloud Alibaba 开源交流群（4群，已满）：30301472\n* Spring Cloud Alibaba 开源交流群（5群，已满）：34930571\n* Spring Cloud Alibaba 开源交流群（6群，已满）：34351718\n* Spring Cloud Alibaba 开源交流群（7群）：2415000986\n\n## 社区相关开源\n\n**[Nepxion Discovery](https://github.com/Nepxion/Discovery)**：一款集成Spring Cloud Alibaba、Nacos、Sentinel等阿里巴巴中间件，实现网关和服务的灰度发布、路由、权重、限流、熔断、降级、隔离、监控、追踪等功能的微服务开源解决。使用指南 请参考 **[Nepxion Discovery Guide](https://github.com/Nepxion/DiscoveryGuide)**。\n","funding_links":[],"categories":["Java","微服务生态","Framework","HarmonyOS","其他__大数据","开发框架","Projects List"],"sub_categories":["Design pattern","Windows Manager","网络服务_其他"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Fspring-cloud-alibaba","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falibaba%2Fspring-cloud-alibaba","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Fspring-cloud-alibaba/lists"}