小白向流程说明（微服务是什么、请求怎么走、代码在哪）见：docs/微服务入门（小白版）.md
工业级、轻量级的「真微服务」学习示例：API 网关 + 服务注册 + 四个独立业务服务，每服务独立数据库（MySQL），用户/商品服务使用 Caffeine 进程内缓存（不依赖 Redis 也能跑），异步消息用 RabbitMQ；基础设施用 Docker Compose 一键拉起（含 Redis 容器，便于你自行扩展练习）。
| 组件 | 作用 |
|---|---|
| Spring Cloud Gateway | 统一入口 8080，路由到各服务 |
| Nacos | 服务注册与发现（各服务通过服务名互相调用） |
user-service 8081 |
用户；MySQL user_db；Caffeine 缓存用户查询；消费订单创建消息（模拟通知） |
product-service 8082 |
商品；MySQL product_db；Caffeine 缓存列表/详情；提供扣减库存接口 |
order-service 8083 |
订单；MySQL order_db；OpenFeign 调用户/商品；下单后 发布 RabbitMQ 事件；提供 查询订单、确认支付 供支付服务调用 |
payment-service 8084 |
支付；MySQL payment_db；OpenFeign 调订单服务；模拟支付成功后写支付流水并将订单置为 PAID |
数据流（下单）简述：
- 客户端只访问网关
POST /api/orders。 - 订单服务用 Feign 同步校验用户、读商品、调用商品服务扣库存、写本库订单。
- 订单服务向交换机
order.exchange发送路由键order.created的消息。 - 用户服务队列
user.order.notify绑定该路由键，异步打印「模拟通知」（体现 异步解耦）。
支付流（模拟）：
- 网关
POST /api/payments，body：{"orderId":1,"channel":"MOCK"}。 - 支付服务 Feign 拉取订单，校验状态为
CREATED；再 Feign 调用POST /api/orders/{id}/pay将订单置为PAID，金额与订单总额一致。 - 支付服务本库写入
payments记录（SUCCESS）。
本仓库已包含：注册中心（Nacos）、网关、声明式 HTTP（Feign）、负载均衡（lb://）、Flyway 迁移、Actuator 健康检查。
未纳入以保持轻量，但生产环境常会继续加：统一配置中心（仍可用 Nacos Config）、分布式链路追踪（Micrometer Tracing + Zipkin/Tempo）、日志聚合（ELK/Loki）、限流熔断（Sentinel）、容器编排（K8s）、CI/CD 等。
- JDK 17+
- Maven 3.8+
- Docker Desktop（用于 Compose 起 MySQL / Redis / RabbitMQ / Nacos）
- 可选前端：Node.js 18+（用于 Vue 3 演示页）
在仓库根目录：
docker compose up -d等待 Nacos 控制台可访问：http://127.0.0.1:8848/nacos（默认账号密码 nacos/nacos）。
RabbitMQ 管理界面：http://127.0.0.1:15672（guest/guest）。
MySQL：127.0.0.1:3307（映射容器内 3306），用户 root，密码 root；首次启动脚本会创建 user_db、order_db、product_db、payment_db。若你使用已有数据卷、库是旧版本脚本建的，请手动执行：CREATE DATABASE IF NOT EXISTS payment_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
mvn clean package -DskipTests在多个终端分别执行（或 IDE 运行主类）：
user-service→com.cluster.user.UserApplicationproduct-service→com.cluster.product.ProductApplicationorder-service→com.cluster.order.OrderApplicationpayment-service→com.cluster.payment.PaymentApplicationgateway→com.cluster.gateway.GatewayApplication
所有服务默认连接本机 127.0.0.1 上的 Nacos / MySQL / RabbitMQ（与 docker-compose.yml 端口一致）。
创建用户：
POST http://127.0.0.1:8080/api/users
Content-Type: application/json
{"username":"alice","email":"alice@example.com"}查看商品列表：
GET http://127.0.0.1:8080/api/products下单（userId 用上一步返回的 id，productId 一般为 1 或 2，来自商品表种子数据）：
POST http://127.0.0.1:8080/api/orders
Content-Type: application/json
{"userId":1,"productId":1,"quantity":2}模拟支付（orderId 为下单返回的 id）：
POST http://127.0.0.1:8080/api/payments
Content-Type: application/json
{"orderId":1,"channel":"MOCK"}查询订单：
GET http://127.0.0.1:8080/api/orders/1观察 user-service 控制台日志，应出现 [异步] 模拟通知；在 RabbitMQ 管理界面可看到队列与消息投递情况。
仓库内 frontend 为 Vite + Vue 3 + Element Plus + Axios：创建用户、查看商品、下单、模拟支付；HTTP 封装在 frontend/src/api/http.js。请求经开发服务器 代理到网关 8080（见 frontend/vite.config.js）。网关已配置 CORS，便于浏览器直接访问 API。
cd frontend
npm install
npm run dev浏览器打开终端里提示的本地地址（一般为 http://127.0.0.1:5173）。需先按上文 启动基础设施 与 四个 Java 服务，否则页面会报错。页头右侧开关可切换 浅色 / 深色（写入 localStorage 键 cluster_theme；无记录时跟随系统偏好）。
各模块已提供 Dockerfile，需在对应模块先 mvn package 再 docker build。若服务跑在容器内，需把环境变量中的 127.0.0.1 改为 Compose 服务名（如 mysql、redis、rabbitmq、nacos），并保证与 Nacos 注册 IP 可达（进阶：host 网络或统一 overlay 网络），此处不展开，避免新手被网络细节绊住。
| 服务 | 端口 |
|---|---|
| gateway | 8080 |
| Vue 演示页 (Vite dev) | 5173 |
| user-service | 8081 |
| product-service | 8082 |
| order-service | 8083 |
| payment-service | 8084 |
| MySQL | 3307 |
| Redis | 6380 |
| RabbitMQ AMQP | 5672 |
| RabbitMQ UI | 15672 |
| Nacos | 8848 |
- 创建用户
/api/users返回 500：先确认 MySQL 已启动（本仓库映射为3307），且 user-service、gateway 已注册到 Nacos；数据库账号密码与application.yml一致（默认root/root）。 - 重复注册同一用户名：应返回 409 与「用户名或邮箱已存在」；若仍用旧数据测试，可换一个用户名或先清表。
- 说明：用户/商品服务曾用 Redis 做 Spring Cache，本地未启动 Redis 时创建用户可能在写缓存阶段 500；现已改为 Caffeine 进程内缓存，不再依赖 Redis 即可跑通；Compose 里的 Redis 仍保留，便于你后续自己接
RedisTemplate等练习。
- 下单与扣库存可改为 本地消息表 + 可靠投递 或 Seata 分布式事务，按业务一致性要求选型。
- 网关可加 鉴权（JWT）、限流、请求日志。
- 为 Feign 增加熔断与重试策略，避免级联故障。
若你希望下一步把 四个 Java 进程也放进 Compose 并一键 docker compose up 跑全栈，可以说明，我可以按你当前 Docker 网络环境补一版可运行的 docker-compose 服务定义。