架构与系统设计 / 系统课时

技术栈与环境准备

技术栈与环境准备

本课把 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 即可。

bash
java -version
mvn -version
docker --version
docker compose version

预期输出如下,具体补丁版本和安装路径可能不同。

text
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。下面的配置为本地开发提供固定端口、健康检查和持久化卷;密码仅适用于个人开发环境,不应直接复制到测试或生产环境。

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。启动服务并等待健康检查完成。

bash
docker compose up -d
docker compose ps

预期结果是三个容器均为运行状态,并最终显示 healthy。启动时间与容器 ID 属于动态值。

text
NAME             SERVICE    STATUS
saas-mysql       mysql      Up <TIME> (healthy)
saas-redis       redis      Up <TIME> (healthy)
saas-rabbitmq    rabbitmq   Up <TIME> (healthy)

验证连接并处理失败

先使用容器内置客户端验证,不依赖本机额外安装数据库工具。三条命令分别检查 MySQL 查询、Redis 回应和 RabbitMQ 节点状态。

bash
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

预期输出如下。

text
ok
1
PONG
Ping succeeded

若端口被占用,执行 docker compose ps 与系统端口查询,停止冲突进程,或只修改左侧宿主机端口,例如把 "3307:3306" 用于本机 MySQL。修改后,Spring Boot 数据源地址也必须同步改为 localhost:3307。

若容器持续 unhealthy,先查看日志,而不是反复重建。以下命令会输出最近 100 行,日志中的认证失败、磁盘不足或初始化错误通常已经给出根因。

bash
docker compose logs --tail=100 mysql redis rabbitmq

预期结果是三组服务日志都包含就绪信息。不同镜像版本的原文会变化,因此用占位符表示实际消息。

text
saas-mysql      | <READY_MESSAGE>
saas-redis      | <READY_MESSAGE>
saas-rabbitmq   | <READY_MESSAGE>

本课总结

  • 统一版本基线比“本机能运行”更重要,它决定团队构建结果是否一致
  • 使用 Compose 可一次启动并持久化 MySQL、Redis 与 RabbitMQ
  • 验收应覆盖版本、容器健康状态和真实连接,而不只检查端口是否打开

下一课预告

下一课将把工程拆成基础设施、认证、租户、业务和接口模块,并建立只能单向依赖的 Maven 多模块骨架。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

技术栈与环境准备

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通