🛠️ 一个基于 Spring Boot 的企业级微服务开发框架

---

📚简介

FUST 谐音 Fast， 是一个基于 Spring Boot 的快速开发框架，提供了：

• 🏗️ 完整的微服务架构 - 基于 Spring Boot 3.x，集成 gRPC、Apollo 配置中心等核心组件
• 🔐 多环境管理 - 支持开发、测试、预发、生产等多环境部署策略
• 🚀 灰度发布 - 内置灰度发布能力，支持按比例发布和白名单/黑名单
• 📊 可观测性 - 集成 OpenTelemetry，提供完整的监控、追踪方案
• 💾 数据访问 - 支持 Redis 多实例、MySQL 读写分离等特性
• 📝 配置管理 - 集成 Apollo 配置中心，支持配置热更新
• 🎯 动态日志 - 自动化的日志配置文件生成，且支持配置中心动态控制

🛠️安装

📦 Maven

在项目的pom.xml的dependencies中加入以下内容:

<dependency>
    <groupId>com.zhihu.fust</groupId>
    <artifactId>fust-boot-starter</artifactId>
    <version>${version}</version>
</dependency>

🐘 Gradle

implementation 'com.zhihu.fust:fust-boot-starter:${version}'

📝快速开始

1. 确保您的开发环境满足以下要求：

   • JDK 17 或更高版本
   • Gradle 8.x

2. 克隆项目：

git clone https://github.com/zhihu/fust

3. 构建项目：

./gradlew build

🎨核心功能

1. 环境管理

• 开发环境 (Development)
• 集成环境 (Integration)
• 测试环境 (Testing)
• 预发环境 (Staging)
• 生产环境 (Production)

2. 配置管理

• Apollo 配置中心集成
• 多环境配置支持
• 配置热更新
• 本地缓存支持

3. 服务通信

• gRPC 服务支持
• HTTP JSON 转码
• API 文档自动生成
• 健康检查

4. 数据访问

• Redis 多实例管理
• 数据库连接池配置
• MyBatis 增强功能
• 读写分离支持

5. 灰度发布

• 支持按比例灰度
• 支持白名单/黑名单
• 支持动态调整

6. 可观测性

• 日志管理
• 链路追踪
• 指标收集
• 性能监控

🧰技术栈

基础框架

• Spring Boot 3.4.1
• MyBatis 3.0.4
• Armeria 1.31.3 (RPC框架)

存储

• Redis (支持 Lettuce/Jedis)
• MySQL

可观测性

• OpenTelemetry 1.46.0

📦模块说明

fust-base (基础模块)

• fust-core: 框架核心功能，包含基础接口定义和通用实现
• fust-provider: SPI 提供者接口，定义框架扩展点
• fust-commons: 通用工具类库

fust-components (组件模块)

• fust-config-apollo: Apollo 配置中心集成
• fust-config-extension: 配置扩展功能，支持配置热更新
• fust-armeria-grpc: gRPC 服务框架集成
• fust-armeria-commons: Armeria 通用功能库
• fust-logging-log4j2: Log4j2 日志框架集成
• fust-telemetry: OpenTelemetry 可观测性集成

fust-boot (自动配置模块)

• fust-boot-jdbc: 数据库连接池自动配置，支持多数据源
• fust-boot-lettuce: Redis Lettuce 客户端自动配置
• fust-boot-jedis: Redis Jedis 客户端自动配置
• fust-boot-grpc: gRPC 服务自动配置
• fust-boot-web: Web 应用自动配置
• fust-boot-log4j2: 日志自动配置
• fust-boot-config: 配置中心自动配置
• fust-boot-mybatis: MyBatis 自动配置

fust-spring (Spring 集成模块)

• fust-spring-web: Web 开发支持，统一异常处理
• fust-spring-redis-common: Redis 通用功能，支持多实例配置
• fust-spring-mybatis: MyBatis 集成增强，支持动态 SQL
• fust-spring-jdbc: JDBC 相关功能增强
• fust-spring-jedis: Jedis 客户端集成
• fust-spring-lettuce: Lettuce 客户端集成

examples (示例项目)

• fust-boot-example: 快速启动示例
  • fust-boot-example-business: 业务逻辑层示例
  • fust-boot-example-grpc: gRPC 服务示例
  • fust-boot-example-api: web api 服务示例

🎯Maven Archetype 使用指南

FUST 提供了项目脚手架，帮助您快速创建基于 FUST 框架的项目。

使用方式

1. 命令行创建(MacOS)

export ORIGIN_HOME=$JAVA_HOME && \
export JAVA_HOME="$(/usr/libexec/java_home -v 17)" && \
mvn archetype:generate -DarchetypeGroupId=com.zhihu.fust \
-DarchetypeArtifactId=fust-boot-archetype -DarchetypeVersion=0.1.0 \
-DinteractiveMode=false -DarchetypeCatalog=local -DgroupId=demo -DartifactId=demo-yoda && \
export JAVA_HOME=$ORIGIN_HOME && unset ORIGIN_HOME

2. IDE 创建

在 IDE 中选择 "Create New Project" -> "Maven" -> "Create from Archetype"，然后搜索 "fust-archetype"。

项目结构

使用 archetype 创建的项目将包含以下结构：

demo-yoda
├── README.md
├── build.sh
├── demo-yoda-api
│   ├── pom.xml
│   └── src
│       └── main
│           ├── java
│           │   └── demo
│           │       └── api
│           │           ├── ApiMain.java
│           │           └── HelloController.java
│           └── resources
├── demo-yoda-business
│   ├── pom.xml
│   └── src
│       ├── main
│       │   └── java
│       │       └── demo
│       │           └── business
│       │               ├── ServiceConfiguration.java
│       │               ├── dao
│       │               ├── dto
│       │               ├── model
│       │               └── service
│       └── test
│           ├── java
│           │   └── test
│           │       └── service
│           │           ├── TestBeanConfig.java
│           │           ├── TestConfiguration.java
│           │           └── TestDao.java
│           └── resources
│               ├── application.properties
│               └── test.sql
├── demo-yoda-grpc
│   ├── pom.xml
│   └── src
│       └── main
│           ├── java
│           │   └── demo
│           │       └── grpc
│           │           ├── GrpcMain.java
│           │           ├── GrpcServer.java
│           │           └── HelloServiceHandler.java
│           └── resources
├── pom.xml
├── proto
│   ├── buf.yaml
│   └── hello.proto
└── run.sh

📐开发建议

1. 遵循模块化开发原则，保持模块间合理分层
2. 使用 proto 文件定义服务接口
3. 合理使用框架提供的功能组件

🏗️参与贡献

欢迎各种形式的贡献，包括：

• 提交问题和需求
• 修复 bug
• 改进文档
• 提交功能优化

📄开源协议

Apache License 2.0