架构与系统设计 / 系统课时
技术栈与环境准备
技术栈与环境准备
本课把 SaaS 多租户系统的本地开发环境一次性准备完整:确认 JDK 与构建工具版本,使用 Docker 启动 MySQL、Redis 和 RabbitMQ,并通过统一检查命令完成连通性验收。
学习目标
- 建立可复现的 JDK、Spring Boot 与 Maven 版本基线
- 启动 MySQL、Redis、RabbitMQ 三类本地依赖
- 根据验证结果定位端口、容器和认证问题
确定版本并检查工具
示例统一采用 JDK 21、Maven 3.9、Spring Boot 3.5.x、MySQL 8、Redis 7 和 RabbitMQ 4。团队应把具体小版本写入工程文件与部署清单,避免成员各自升级后出现编译或协议差异。
| 组件 | 建议基线 | 本课用途 |
|---|---|---|
| JDK | 21 | 编译和运行 Spring Boot |
| Maven | 3.9.x | 依赖解析与多模块构建 |
| Docker | 近期稳定版 | 运行本地中间件 |
| MySQL | 8.x | 保存租户、用户和业务数据 |
| Redis | 7.x | 缓存、分布式锁和短期状态 |
| RabbitMQ | 4.x | 处理异步事件与解耦任务 |
先在终端执行版本检查。Windows 可在 PowerShell、Git Bash 或 WSL 中运行等价命令;只要最终能调用 java、mvn、docker 和 docker compose 即可。
java -version
mvn -version
docker --version
docker compose version预期输出如下,具体补丁版本和安装路径可能不同。
openjdk version "21.<PATCH>"
Apache Maven 3.9.<PATCH>
Docker version <VERSION>, build <ID>
Docker Compose version v<VERSION>若出现“command not found”或“不是内部或外部命令”,先修正 PATH,再重新打开终端。java -version 与 mvn -version 显示的 Java 主版本都应为 21,否则 Maven 可能仍在使用旧 JDK。
启动本地基础服务
在项目根目录创建 compose.yaml。下面的配置为本地开发提供固定端口、健康检查和持久化卷;密码仅适用于个人开发环境,不应直接复制到测试或生产环境。
services:
mysql:
image: mysql:8.4
container_name: saas-mysql
environment:
MYSQL_ROOT_PASSWORD: local-root
MYSQL_DATABASE: saas_app
MYSQL_USER: saas
MYSQL_PASSWORD: local-saas
ports:
- "3306:3306"
volumes:
- mysql-data:/var/lib/mysql
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uroot", "-plocal-root"]
interval: 5s
timeout: 3s
retries: 20
redis:
image: redis:7.4
container_name: saas-redis
command: ["redis-server", "--appendonly", "yes"]
ports:
- "6379:6379"
volumes:
- redis-data:/data
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 5s
timeout: 3s
retries: 20
rabbitmq:
image: rabbitmq:4-management
container_name: saas-rabbitmq
environment:
RABBITMQ_DEFAULT_USER: saas
RABBITMQ_DEFAULT_PASS: local-rabbit
ports:
- "5672:5672"
- "15672:15672"
volumes:
- rabbitmq-data:/var/lib/rabbitmq
healthcheck:
test: ["CMD", "rabbitmq-diagnostics", "-q", "ping"]
interval: 5s
timeout: 5s
retries: 20
volumes:
mysql-data:
redis-data:
rabbitmq-data:该配置生效后,MySQL 监听 3306,Redis 监听 6379,RabbitMQ AMQP 监听 5672,管理页面监听 15672。启动服务并等待健康检查完成。
docker compose up -d
docker compose ps预期结果是三个容器均为运行状态,并最终显示 healthy。启动时间与容器 ID 属于动态值。
NAME SERVICE STATUS
saas-mysql mysql Up <TIME> (healthy)
saas-redis redis Up <TIME> (healthy)
saas-rabbitmq rabbitmq Up <TIME> (healthy)验证连接并处理失败
先使用容器内置客户端验证,不依赖本机额外安装数据库工具。三条命令分别检查 MySQL 查询、Redis 回应和 RabbitMQ 节点状态。
docker exec saas-mysql mysql -usaas -plocal-saas -Dsaas_app -e "SELECT 1 AS ok;"
docker exec saas-redis redis-cli ping
docker exec saas-rabbitmq rabbitmq-diagnostics -q ping预期输出如下。
ok
1
PONG
Ping succeeded若端口被占用,执行 docker compose ps 与系统端口查询,停止冲突进程,或只修改左侧宿主机端口,例如把 "3307:3306" 用于本机 MySQL。修改后,Spring Boot 数据源地址也必须同步改为 localhost:3307。
若容器持续 unhealthy,先查看日志,而不是反复重建。以下命令会输出最近 100 行,日志中的认证失败、磁盘不足或初始化错误通常已经给出根因。
docker compose logs --tail=100 mysql redis rabbitmq预期结果是三组服务日志都包含就绪信息。不同镜像版本的原文会变化,因此用占位符表示实际消息。
saas-mysql | <READY_MESSAGE>
saas-redis | <READY_MESSAGE>
saas-rabbitmq | <READY_MESSAGE>本课总结
- 统一版本基线比“本机能运行”更重要,它决定团队构建结果是否一致
- 使用 Compose 可一次启动并持久化 MySQL、Redis 与 RabbitMQ
- 验收应覆盖版本、容器健康状态和真实连接,而不只检查端口是否打开
下一课预告
下一课将把工程拆成基础设施、认证、租户、业务和接口模块,并建立只能单向依赖的 Maven 多模块骨架。