# lambda-cloud-parent

**Repository Path**: westboy/lambda-cloud-parent

## Basic Information

- **Project Name**: lambda-cloud-parent
- **Description**: Lambda Cloud 是一个基于 Spring Boot 4.0.2 和 Spring Cloud 2025.1.1 构建的企业级微服务开发框架。它旨在帮助中小型企业降低微服务架构的开发与运维成本。框架对多种主流中间件进行了统一封装与自动化配置，具备 开箱即用、高度模块化、易于扩展 等特性，是快速搭建稳定、可维护的企业级分布式系统的理想选择.
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 13
- **Forks**: 5
- **Created**: 2024-06-20
- **Last Updated**: 2026-07-12

## Categories & Tags

**Categories**: microservice

**Tags**: None

## README

<div align="center">
<p align="center">
	<img alt="logo" src="assets/logo.png" width="250" height="250">
</p>

# 🚀 Lambda Cloud Framework

**基于 Spring Boot 4.0 + JDK 21 构建的全栈企业级微服务开发框架**

<p align="center">
  <a href="https://gitee.com/lamuda-cloud/lamuda-cloud-parent">
    <img src="https://img.shields.io/badge/lambda--cloud-2026.1.1--SNAPSHOT-brightgreen" alt="Lambda Cloud">
  </a>
  <a href="https://spring.io/projects/spring-boot">
    <img src="https://img.shields.io/badge/Spring%20Boot-4.0.2-brightgreen" alt="Spring Boot">
  </a>
  <a href="https://spring.io/projects/spring-cloud">
    <img src="https://img.shields.io/badge/Spring%20Cloud-2025.1.1-brightgreen" alt="Spring Cloud">
  </a>
  <a href="https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html">
    <img src="https://img.shields.io/badge/JDK-21-blue" alt="JDK">
  </a>
</p>
</div>

---

**Lambda Cloud** 是一个基于 **Spring Boot 4.0.2** 和 **Spring Cloud 2025.1.1** 构建的企业级微服务开发框架。它旨在帮助中小型企业降低微服务架构的开发与运维成本。框架对多种主流中间件进行了统一封装与自动化配置，具备 开箱即用、高度模块化、易于扩展 等特性，是快速搭建稳定、可维护的企业级分布式系统的理想选择。

## 核心优势 

- 🚀 **现代化技术栈**：基于 Spring Boot 4.0.2、Spring Cloud 2025.1.1、Spring Cloud Alibaba 2025.1.0.0、JDK 21
- 🧩 **高度模块化**：27 个独立模块（含 core/processor/BOM 与各 starter），支持灵活组合，按需引入，避免依赖膨胀
- 🔐 **企业级安全**：集成 Sa-Token 1.45.0，支持表单登录、短信登录、HMAC 签名认证、第三方登录（微信小程序）、XSS 防护等多种认证方式
- 💾 **MyBatis Plus 增强**：扩展 Mapper（批量插入、编码字段操作、Exists 判断）、自动填充、多租户行级隔离、字段加密、数据权限改写等企业级功能
- 🔧 **自动化配置**：所有中间件均提供自动配置，零配置即可快速启动，支持细粒度定制和条件装配
- 🌐 **微服务全栈支持**：Dubbo 3.3.6、OpenFeign 双 RPC、Nacos 注册中心、Gateway 网关、RocketMQ 消息队列
- 📦 **统一依赖管理**：通过 `lambda-cloud-starter-dependencies` 管理所有组件版本，避免依赖冲突
- 🎯 **协议引擎**：基于 Netty 的高性能二进制协议解析引擎，支持注解驱动的协议定义、CRC 校验、字段加解密、List/Composite 复合结构解析
- 💡 **智能对象转换**：基于 MapStruct 1.6.3 的编译期对象转换，支持 @AutoConverter 注解驱动、@FieldMapping 字段映射和自定义转换函数
- 📊 **多级缓存**：统一缓存抽象层，支持 Redis、Caffeine 和 L1+L2 多级缓存架构，提供跨节点 L1 失效同步能力（Redis Pub/Sub）
- 🔄 **动态数据源**：支持单数据源和动态多数据源，提供运行时数据源增删改查与连通性测试能力
- 📡 **增强 RPC**：Dubbo 增强支持认证透传、租户上下文、调用日志、调用指标、健康检查与重试；Feign 支持请求头透传、错误解码与重试
- 🛡️ **网关增强**：Gateway 提供防火墙鉴权、CORS、路由扩展、Swagger 聚合、黑名单过滤、租户路由改写等能力

## 技术栈

| 分类 | 技术 | 版本 | 说明 |
| --- | --- | --- | --- |
| **核心框架** | JDK | 21 | 运行环境，支持虚拟线程 |
| | Spring Boot | 4.0.2 | 应用框架 |
| | Spring Cloud | 2025.1.1 | 微服务框架 |
| | Spring Cloud Alibaba | 2025.1.0.0 | 阿里巴巴微服务解决方案 |
| | Spring AI | 1.1.2 | AI 应用开发支持 |
| **数据持久化** | MyBatis Plus | 3.5.15 | ORM 框架，支持扩展 Mapper、多租户、字段加密、数据权限 |
| | Dynamic Datasource | 4.5.0 | 动态数据源管理 |
| | MySQL | 8.2.0 | 关系型数据库 |
| | Liquibase | 5.0.2 | 数据库版本管理 |
| | Apache IoTDB | 2.0.3 | 时序数据库，支持 Tree/Table 模型和订阅功能 |
| | P6Spy | 3.9.1 | SQL 性能监控 |
| **缓存** | Redis | - | 分布式缓存 |
| | Redisson | 4.3.0 | Redis 客户端，支持分布式锁和延迟队列 |
| | Caffeine | - | 本地缓存 |
| | Lambda Cache | - | 统一缓存抽象层，支持 Redis/Caffeine/多级缓存 |
| | RocketMQ | 2.3.4 | 分布式消息中间件 |
| **RPC 框架** | Dubbo | 3.3.6 | 高性能 RPC 框架，支持认证透传、租户上下文、调用日志、指标、健康检查 |
| | OpenFeign | - | 声明式 HTTP 客户端，支持请求头透传、错误解码、重试 |
| **安全认证** | Sa-Token | 1.45.0 | 权限认证框架，支持表单登录、短信登录、HMAC 签名认证、第三方登录、XSS 防护 |
| | BouncyCastle | 1.77 | 加密算法库 |
| **网络通信** | Netty | - | 高性能网络框架，支持协议引擎、CRC 校验、字段加解密、List/Composite 解析 |
| | OkHttp | 4.12.0 | HTTP 客户端 |
| **对象映射** | MapStruct | 1.6.3 | Java Bean 映射工具，编译期代码生成 |
| **API 文档** | Knife4j | - | Swagger 增强工具 |
| | SpringDoc | - | OpenAPI 3 文档生成 |
| **微信开发** | WxJava | 4.7.0 | 微信开发 Java SDK |
| **工具库** | Lombok | 1.18.34 | 简化 Java 代码 |
| | Guava | 33.2.1-jre | Google 核心工具库 |
| | Gson | 2.11.0 | JSON 序列化库 |
| | Fastjson | 1.2.83 | JSON 序列化库 |
| **日志** | SLF4J | 2.0.16 | 日志门面接口 |
| **监控** | Actuator | - | 应用监控和管理，支持 Micrometer 指标切面 |
| | Jacoco | 0.8.12 | 代码覆盖率 |
| **代码质量** | Spotless | 2.44.4 | 代码格式化 |
| | Spotbugs | 4.9.3.0 | 代码静态分析 |
| **云原生** | Nacos | - | 服务注册与配置中心 |

## 模块概览

```
lambda-cloud-parent
│
├── lambda-cloud-core                    # 核心功能与通用工具包
│
├── lambda-cloud-processor               # 编译期注解处理器
│
├── lambda-cloud-starter-dependencies    # 项目统一依赖版本管理（BOM）
│
├── lambda-cloud-starter-web             # Web 基础配置
│
├── lambda-cloud-starter-swagger         # API 文档生成（Knife4j/SpringDoc）
│
├── lambda-cloud-starter-gateway         # Spring Cloud Gateway 网关增强
│
├── lambda-cloud-starter-mybatis         # MyBatis Plus 增强
│
├── lambda-cloud-starter-datasource      # 动态数据源管理
│
├── lambda-cloud-starter-liquibase       # 数据库版本管理工具集成
│
├── lambda-cloud-starter-iotdb           # IoTDB 时序数据库集成（Tree/Table 模型、订阅功能）
│
├── lambda-cloud-starter-cache           # 统一缓存抽象层
│
├── lambda-cloud-starter-redis           # Redis 访问基础能力
│
├── lambda-cloud-starter-rocketmq        # RocketMQ 消息队列集成
│
├── lambda-cloud-starter-dubbo           # Dubbo RPC 增强
│
├── lambda-cloud-starter-feign           # OpenFeign 增强
│
├── lambda-cloud-starter-security        # 安全认证模块
│
├── lambda-cloud-starter-netty           # Netty 网络通信框架
│
├── lambda-cloud-starter-websocket       # WebSocket 通信支持
│
├── lambda-cloud-starter-sse             # Server-Sent Events 支持
│
├── lambda-cloud-starter-actuator        # 监控增强
│
├── lambda-cloud-starter-logger          # 日志统一采集与追踪
│
├── lambda-cloud-starter-oss             # 对象存储（MinIO、OSS）支持
│
├── lambda-cloud-starter-sms             # 短信网关支持
│
├── lambda-cloud-starter-ykc             # 云快充协议支持（基于 Netty 协议引擎）
│
├── lambda-cloud-starter-webclient       # WebClient HTTP 客户端支持
│
├── lambda-cloud-starter-nacos           # Nacos 服务注册与配置中心集成
│
└── lambda-cloud-starter-test            # 测试工具与集成测试支持
```

## 快速开始

### 环境要求

- **JDK**：21 或更高版本
- **构建工具**：Maven 3.6+

### 添加依赖

在您的 Maven 项目中引入 Lambda Cloud 的 BOM：

```xml
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.lambda.cloud</groupId>
            <artifactId>lambda-cloud-starter-dependencies</artifactId>
            <version>2026.1.1-SNAPSHOT</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
```

然后根据需要添加相应的 starter 依赖，例如：

```xml
<dependencies>
    <!-- Web 模块 -->
    <dependency>
        <groupId>com.lambda.cloud</groupId>
        <artifactId>lambda-cloud-starter-web</artifactId>
    </dependency>
    
    <!-- 安全认证模块 -->
    <dependency>
        <groupId>com.lambda.cloud</groupId>
        <artifactId>lambda-cloud-starter-security</artifactId>
    </dependency>
    
    <!-- MyBatis Plus 模块 -->
    <dependency>
        <groupId>com.lambda.cloud</groupId>
        <artifactId>lambda-cloud-starter-mybatis</artifactId>
    </dependency>
    
    <!-- Redis 缓存模块 -->
    <dependency>
        <groupId>com.lambda.cloud</groupId>
        <artifactId>lambda-cloud-starter-redis</artifactId>
    </dependency>
    
    <!-- Dubbo RPC 模块 -->
    <dependency>
        <groupId>com.lambda.cloud</groupId>
        <artifactId>lambda-cloud-starter-dubbo</artifactId>
    </dependency>
</dependencies>
```

## 应用场景

- 🏢 **企业级微服务与 SaaS 平台**  
  适用于快速构建企业信息化系统与 SaaS 应用。框架内置多租户管理、数据权限、安全认证等核心能力，帮助企业在微服务架构下实现高效、稳定的业务系统。

- 📱 **IoT 设备接入与管理**  
  基于 Netty 协议引擎，支持高并发 TCP 长连接与协议自动解析。可广泛应用于充电桩、网关、传感器等物联网设备的接入、监控与远程控制。

- 📊 **时序数据与大数据分析平台**  
  集成 IoTDB 时序数据库与多源数据处理能力，支持高性能采集、实时查询与可视化分析，适用于工业监控、能耗管理等数据密集型场景。

- 🛍️ **电商与交易系统**  
  结合 Redis 缓存、消息队列与分布式锁机制，轻松应对高并发下的库存、订单、支付等核心业务，确保系统高可用与一致性。

- 💳 **支付与清结算平台**  
  提供 HMAC 签名认证、多数据源管理与分布式事务支持，助力构建安全可靠的支付网关与清结算系统。

- 🌐 **开放平台与网关服务**  
  集成 Dubbo、OpenFeign、Gateway 与 Knife4j 文档体系，帮助企业快速搭建统一的 API 接入与管理平台，实现服务聚合与安全控制。

- 🛡️ **高安全互联网应用**  
  提供基于 Sa-Token 的统一认证体系，结合 XSS/CSRF 防护、字段加密与审计日志功能，为安全敏感型应用提供全方位防护。


## 版本说明

- 当前版本：2026.1.1-SNAPSHOT
- Java 版本：21+
- Spring Boot 版本：4.0.2
- Spring Cloud 版本：2025.1.1

## 贡献指南

欢迎贡献代码、提交问题和建议！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## License

采用 Apache License 2.0 协议，详见 [LICENSE](LICENSE) 文件。

## 交流群

QQ交流群：47736663 [点击加入](https://qm.qq.com/q/EBIJVZBVGE)