bubble 是一个基于 Spring Boot 3.x 和 Spring Cloud 2025.x 的现代化微服务开发框架，旨在为企业级项目快速开发提供一系列的基础能力和最佳实践。项目采用模块化设计，支持 Java 17+ 和云原生架构，集成了 Spring AI、Spring Modulith 等前沿技术，方便使用者根据项目需求快速进行功能拓展。
- 现代化技术栈: 基于 Spring Boot 3.5.7、Spring Cloud 2025.0.0、Java 17
- AI 集成: 内置 Spring AI 1.0.3 支持，轻松构建智能化应用
- 模块化架构: 采用 Spring Modulith 实现模块化单体架构
- 云原生支持: 完整的微服务治理能力，支持容器化部署
- 开箱即用: 提供丰富的 Starter 模块，快速集成常用功能
- 生产就绪: 内置监控、日志、安全等生产级特性
- 性能优化: 针对高并发场景进行深度优化
bubble/
├── bubble-core/ # 核心工具库
├── bubble-dependencies/ # 依赖管理 BOM
├── bubble-parent/ # 父级 POM
├── bubble-ai/ # AI 能力聚合模块
│ └── bubble-ai-starters/
│ ├── bubble-ai-starter/ # AI 基础 Starter
│ └── bubble-ai-starter-lightrag/ # LightRAG 集成 Starter
└── bubble-starters/ # Starter 模块集合
├── bubble-starter/ # 基础 Starter
├── bubble-starter-web/ # Web 开发 Starter
├── bubble-starter-data-redis/ # Redis 集成 Starter
├── bubble-starter-data-mybatis-plus/ # MyBatis Plus Starter
├── bubble-starter-data-elasticsearch/ # Elasticsearch Starter
├── bubble-starter-data-duckdb/ # DuckDB 集成 Starter
├── bubble-starter-dubbo/ # Dubbo 微服务 Starter
├── bubble-starter-dubbo-registry-redis/ # Dubbo Redis 注册中心
├── bubble-starter-satoken/ # Sa-Token 权限认证 Starter
├── bubble-starter-logging/ # 日志增强 Starter
├── bubble-starter-lock/ # 分布式锁 Starter
├── bubble-starter-mail/ # 邮件发送 Starter
├── bubble-starter-excel/ # Excel 处理 Starter
├── bubble-starter-i18n/ # 国际化 Starter
├── bubble-starter-xxl-job/ # XXL-Job 任务调度 Starter
└── bubble-starter-test/ # 测试增强 Starter
| 技术 | 版本 | 说明 |
|---|---|---|
| Java | 17+ | 基础运行环境 |
| Spring Boot | 3.5.7 | 应用框架 |
| Spring Cloud | 2025.0.0 | 微服务框架 |
| Spring Cloud Alibaba | 2023.0.3.3 | 阿里云微服务套件 |
| Spring AI | 1.0.3 | AI 集成框架 |
| Spring Modulith | 1.4.4 | 模块化架构 |
| MyBatis Plus | 3.5.14 | ORM 框架 |
| Redis | - | 缓存中间件 |
| Elasticsearch | 7.13.4 | 搜索引擎 |
| Dubbo | 3.3.5 | RPC 框架 |
| Sa-Token | 1.44.0 | 权限认证框架 |
| XXL-Job | 3.1.0 | 分布式任务调度 |
| Hutool | 5.8.41 | Java 工具库 |
| Lombok | 1.18.42 | 代码简化工具 |
- JDK 17+
- Maven 3.6+
- Redis 6.0+（可选）
- MySQL 8.0+（可选）
在项目的 pom.xml 中添加依赖管理：
<dependencyManagement>
<dependencies>
<dependency>
<groupId>cn.fxbin.bubble</groupId>
<artifactId>bubble-dependencies</artifactId>
<version>2.0.0.BUILD-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement><!-- Web 开发 -->
<dependency>
<groupId>cn.fxbin.bubble</groupId>
<artifactId>bubble-starter-web</artifactId>
</dependency>
<!-- Redis 缓存 -->
<dependency>
<groupId>cn.fxbin.bubble</groupId>
<artifactId>bubble-starter-data-redis</artifactId>
</dependency>
<!-- MyBatis Plus -->
<dependency>
<groupId>cn.fxbin.bubble</groupId>
<artifactId>bubble-starter-data-mybatis-plus</artifactId>
</dependency>当前版本：2.0.0.BUILD-SNAPSHOT
- 全面升级至 Spring Boot 3.x 和 Spring Cloud 2025.x
- 支持 Java 17+ 和 GraalVM 原生镜像
- 集成 Spring AI 和 Spring Modulith
- 性能优化和安全增强
- 完善的云原生支持
所有 JAR 包都已推送至 Maven 中央仓库，每个版本的详细更新日志请查看 CHANGELOG.md
我们欢迎所有形式的贡献，包括但不限于：
- 🐛 Bug 报告和修复
- ✨ 新功能建议和实现
- 📝 文档改进
- 🎨 代码优化
- 🧪 测试用例补充
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
- 遵循 阿里巴巴 Java 开发手册
- 使用 Conventional Commits 规范提交信息
- 确保代码覆盖率不低于 80%
- 所有 Public API 必须有完整的 Javadoc
详细的版本更新记录请查看：CHANGELOG.md
- 官方文档: https://fxbin.github.io/bubble
- 示例项目: bubble-examples
- 问题反馈: GitHub Issues
- 讨论交流: GitHub Discussions
感谢所有为 bubble 项目做出贡献的开发者们！
本项目基于 Apache License 2.0 开源协议，详情请参阅 LICENSE 文件。
- 作者: fanxubin
- 邮箱: fxbin123@gmail.com
- GitHub: @fxbin
如果这个项目对你有帮助，请给个 ⭐️ Star 支持一下！