# spring-cloud

**Repository Path**: welunatic/spring-cloud

## Basic Information

- **Project Name**: spring-cloud
- **Description**: 微服务练手项目
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Spring Cloud 示例项目

这是一个基于 Spring Cloud 的微服务架构示例项目，包含了多个服务组件，演示了服务注册与发现、配置中心、网关、服务调用等核心功能。

## 项目结构

- **eureka-server**：服务注册与发现中心（Eureka Server）
- **config-server**：配置中心（Spring Cloud Config）
- **gateway-server**：API 网关（Spring Cloud Gateway）
- **order-service**：订单服务，使用 Feign 进行服务调用，并集成 Hystrix 熔断机制
- **user-service & user1-service**：用户服务，提供简单的登录接口，用于演示多实例服务

## 主要功能

- 服务注册与发现：所有服务启动后会自动注册到 Eureka Server
- 配置管理：通过 Config Server 管理配置文件
- 路由网关：通过 Gateway Server 统一访问服务接口
- 服务调用：Order Service 通过 Feign 调用 User Service 接口
- 熔断机制：使用 Hystrix 提供服务降级功能

## 快速开始

### 启动顺序

1. 启动 `eureka-server`
2. 启动 `config-server`
3. 启动 `gateway-server`
4. 启动 `user-service` 和 `user1-service`
5. 启动 `order-service`

### 访问方式

- Eureka Server UI：`http://localhost:8761`
- Config Server：`http://localhost:8888`
- 用户服务登录接口：`http://localhost:8081/login` 或通过网关访问 `/user-service/login`
- 订单服务接口：`http://localhost:8082/order/list` 或通过网关访问 `/order-service/order/list`

## 服务说明

### Eureka Server

服务注册中心，所有微服务启动后会自动注册到 Eureka Server。

### Config Server

集中管理所有服务的配置文件，支持动态刷新配置。

### Gateway Server

API 网关，统一入口，负责路由转发和权限控制。

### Order Service

订单服务，演示了 Feign 调用和 Hystrix 熔断机制。

- `/order/list`：调用用户服务，展示订单列表
- `/order/cancel`：取消订单接口（未实现具体逻辑）
- `/order/payment`：支付接口（未实现具体逻辑）

### User Service & User1 Service

用户服务，提供登录接口，用于演示服务调用和负载均衡。

- `/login`：返回当前服务端口，用于验证负载均衡效果

## 注意事项

- 所有服务默认使用 8080 端口，为了避免冲突，已在配置文件中为每个服务指定了不同端口
- 使用 Feign 时启用了负载均衡，调用会自动选择可用服务实例
- Hystrix 提供了服务降级功能，当依赖服务不可用时会返回预设的降级结果

## 贡献指南

欢迎提交 Pull Request，贡献代码或改进文档。请遵循以下规范：

1. Fork 项目
2. 创建新分支
3. 提交代码
4. 创建 Pull Request

## 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。