# 基础后端集成

**Repository Path**: iwxp11/BaseBackend

## Basic Information

- **Project Name**: 基础后端集成
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2025-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BaseBackend 项目

基于 Spring Boot 2.7.18 和 Java 1.8 的多模块后端项目。

## 项目结构

```
BaseBackend/
├── dependency-management/     # 依赖管理模块
├── core-system/              # 核心系统模块
├── web/                      # Web应用模块
└── pom.xml                   # 根项目配置
```

## 技术栈

- **Java**: 1.8
- **Spring Boot**: 2.7.18
- **Spring Cloud**: 2021.0.8
- **Spring Cloud Alibaba**: 2021.0.5.0
- **Nacos**: 2.2.4 (服务发现 + 配置管理)
- **构建工具**: Maven
- **数据库**: H2 (开发环境) / MySQL (生产环境)
- **ORM**: Spring Data JPA + MyBatis-Plus
- **服务调用**: OpenFeign + LoadBalancer
- **API文档**: Swagger2
- **工具库**: Lombok

## 模块说明

### dependency-management
统一管理项目依赖版本，确保各模块依赖版本一致性。

### core-system
核心业务模块，包含：
- 统一API响应格式 (`ApiResponse`)
- 自定义异常处理 (`ApiException`, `GlobalExceptionHandler`)
- 基础配置和工具类
- 测试控制器

**启动端口**: 8080

### web
Web应用模块，包含：
- 依赖core-system模块
- MyBatis-Plus代码生成器
- Swagger API文档
- Web层相关配置

**启动端口**: 8081

## 快速开始

### 编译项目
```bash
mvn clean compile
```

### 打包项目
```bash
mvn clean package
```

### 运行core-system模块
```bash
cd core-system
mvn spring-boot:run
```
访问: http://localhost:8080/api/test

### 运行web模块
```bash
cd web
mvn spring-boot:run
```
访问: http://localhost:8081

### 启动Nacos服务器
```bash
# 下载并启动Nacos 2.2.4 (单机模式)
./nacos/bin/startup.sh -m standalone

# Windows环境
./nacos/bin/startup.cmd -m standalone
```
访问Nacos控制台: http://localhost:8848/nacos (nacos/nacos)

### 代码生成器
运行 `GeneratorUIApp` 类启动MyBatis-Plus代码生成器UI:
```bash
cd web
mvn exec:java -Dexec.mainClass="com.iwxp.backend.front.generator.GeneratorUIApp"
```
访问: http://localhost:8068

## 数据库配置

### 开发环境 (H2)
项目默认使用H2内存数据库，无需额外配置。

H2控制台访问:
- core-system: http://localhost:8080/h2-console
- web: http://localhost:8081/h2-console

### 生产环境 (MySQL)
修改 `application.yml` 中的数据库配置:
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database
    username: your_username
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver
```

## API文档

启动web模块后，访问Swagger UI:
http://localhost:8081/swagger-ui.html

## Nacos集成功能

### 服务发现
- 自动服务注册与发现
- 服务健康检查
- 负载均衡

### 配置管理
- 集中配置管理
- 配置热更新
- 多环境配置隔离

### 服务调用
- OpenFeign声明式服务调用
- 服务降级处理
- 负载均衡策略

### 测试接口
```bash
# Core System服务
curl http://localhost:8080/api/test
curl http://localhost:8080/api/discovery/services
curl http://localhost:8080/api/discovery/info

# Web Application服务
curl http://localhost:8081/api/web/test
curl http://localhost:8081/api/web/call-core
curl http://localhost:8081/api/web/discovery
curl http://localhost:8081/api/web/core-services

# 健康检查
curl http://localhost:8080/actuator/health
curl http://localhost:8081/actuator/health
```

## 最近更新

✅ **Nacos集成** (最新):
- 集成Spring Cloud Alibaba 2021.0.5.0
- 配置Nacos服务发现和配置管理
- 实现OpenFeign服务间调用
- 添加服务降级处理
- 支持配置热更新
- 完善健康检查和监控

✅ **依赖管理问题修复**:
- 启用根项目的dependencyManagement
- 统一各模块依赖版本
- 修复MySQL连接器依赖迁移问题
- 完善web模块启动类
- 修复代码生成器类导入问题

✅ **编译构建**:
- Maven编译成功
- 打包构建成功
- 所有模块依赖正常解析

## 开发规范

- 使用Lombok简化代码
- 统一异常处理机制
- RESTful API设计
- 代码注释完整
- 遵循阿里巴巴Java开发手册

## 联系方式

项目维护者: Craft