# id_error

**Repository Path**: powercs12/id_error

## Basic Information

- **Project Name**: id_error
- **Description**: 雪花id算法探索
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-20
- **Last Updated**: 2025-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Spring Boot + MyBatis-Plus 项目

这是一个集成了Spring Boot、MyBatis和MyBatis-Plus的示例项目，提供了完整的用户管理功能。

## 项目结构

```
springboot-mybatis-demo/
├── src/
│   ├── main/
│   │   ├── java/com/example/demo/
│   │   │   ├── config/          # 配置类
│   │   │   ├── controller/      # 控制器
│   │   │   ├── entity/          # 实体类
│   │   │   ├── mapper/          # Mapper接口
│   │   │   ├── service/         # 服务层
│   │   │   └── SpringbootMybatisDemoApplication.java # 启动类
│   │   └── resources/
│   │       ├── sql/             # SQL脚本
│   │       └── application.yml  # 配置文件
│   └── test/                    # 测试类
└── pom.xml                      # Maven配置文件
```

## 技术栈

- Spring Boot 3.2.0
- MyBatis-Plus 3.5.4
- MySQL 8.0
- Lombok
- Maven

## 功能特性

- ✅ 用户表创建和管理
- ✅ 用户实体类定义
- ✅ MyBatis-Plus集成
- ✅ 完整的CRUD操作
- ✅ RESTful API接口
- ✅ 自动填充字段
- ✅ 逻辑删除
- ✅ 跨域支持

## API接口

### 用户管理接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/users` | 获取所有用户 |
| GET | `/api/users/{id}` | 根据ID获取用户 |
| GET | `/api/users/username/{username}` | 根据用户名获取用户 |
| GET | `/api/users/email/{email}` | 根据邮箱获取用户 |
| GET | `/api/users/age-range?minAge={minAge}&maxAge={maxAge}` | 根据年龄范围获取用户 |
| POST | `/api/users` | 创建用户 |
| PUT | `/api/users/{id}` | 更新用户信息 |
| DELETE | `/api/users/{id}` | 删除用户 |

## 数据库配置

### MySQL配置
在 `application.yml` 中配置数据库连接：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/demo_db?useSSL=false&serverTimezone=UTC&characterEncoding=utf8
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver
```

### 数据库初始化

1. 创建数据库：
```sql
CREATE DATABASE demo_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 执行SQL脚本：
```sql
-- 执行 src/main/resources/sql/user.sql 中的脚本
```

## 快速开始

1. **克隆项目**
```bash
git clone <项目地址>
cd springboot-mybatis-demo
```

2. **配置数据库**
- 创建MySQL数据库
- 修改 `application.yml` 中的数据库连接配置

3. **运行项目**
```bash
# 使用Maven运行
mvn spring-boot:run

# 或者直接运行启动类
# SpringbootMybatisDemoApplication.java
```

4. **测试API**
项目启动后，可以通过以下方式测试API：

- 浏览器访问：http://localhost:8080/api/users
- 使用Postman或curl进行接口测试
- 运行测试类：`UserServiceTest`

## 测试示例

### 创建用户
```bash
curl -X POST http://localhost:8080/api/users \
  -H "Content-Type: application/json" \
  -d '{
    "username": "newuser",
    "password": "password123",
    "email": "newuser@example.com",
    "phone": "13800138000",
    "age": 25
  }'
```

### 获取所有用户
```bash
curl http://localhost:8080/api/users
```

### 更新用户
```bash
curl -X PUT http://localhost:8080/api/users/1 \
  -H "Content-Type: application/json" \
  -d '{
    "username": "updateduser",
    "email": "updated@example.com",
    "age": 30
  }'
```

### 删除用户
```bash
curl -X DELETE http://localhost:8080/api/users/1
```

## 注意事项

1. **数据库连接**：确保MySQL服务已启动，并且数据库配置正确
2. **端口冲突**：如果8080端口被占用，可以在 `application.yml` 中修改端口
3. **依赖下载**：首次运行可能需要下载依赖，请保持网络畅通
4. **逻辑删除**：删除操作是逻辑删除，数据仍然存在于数据库中

## 扩展功能

你可以基于这个项目进行扩展：

- 添加用户认证和授权
- 集成Redis缓存
- 添加分页查询
- 实现文件上传功能
- 添加更多的业务逻辑

## 问题反馈

如遇到问题，请检查：
1. 数据库连接配置是否正确
2. MySQL服务是否正常运行
3. 依赖是否完整下载
4. 查看控制台日志获取详细错误信息