# spring-boot-study

**Repository Path**: vsiryxm/spring-boot-study

## Basic Information

- **Project Name**: spring-boot-study
- **Description**: spring-boot框架学习笔记
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-10
- **Last Updated**: 2025-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Spring Boot Demo 学生管理系统

## 项目简介
本项目为基于 Spring Boot 的学生管理系统 Demo，涵盖学生、成绩、班级、年级、课程、管理员等核心功能，适合 Spring Boot/MyBatis-Plus/企业级开发新手学习与实践。

## 技术栈
- Spring Boot 2.3.x
- MyBatis-Plus 3.4.x
- Druid 数据源
- MySQL 8.x
- Lombok
- JWT 认证
- Swagger/OpenAPI 3.0
- Redis（可选）

## 主要功能
- 学生/成绩/班级/年级/课程/管理员的增删改查
- 学生成绩多表联查、分页、模糊查询
- JWT 登录认证与权限控制
- 主从数据源与自动读写分离
- 统一 API 响应格式
- 自动化 API 文档（Swagger UI）
- 日志输出（@Slf4j）

## 快速开始
### 1. 克隆项目
```bash
git clone https://gitee.com/vsiryxm/spring-boot-study.git
cd javaproject/sprint-boot-study/spring-boot-demo
```

### 2. 数据库准备
- 创建数据库，导入 `db_student.sql` 脚本
- 修改 `application-dev.properties` 数据库连接配置

### 3. 编译与运行
```bash
# 编译
mvn clean package
# 运行
mvn spring-boot:run
# 或
java -jar target/spring-boot-demo-1.0-SNAPSHOT.jar
```

### 4. 访问接口
- Swagger UI: [http://localhost:8085/swagger-ui.html](http://localhost:8085/swagger-ui.html)
- 主要 API 路径：/student、/score、/class、/grade、/course、/admin

### 5. 断点调试（VSCode）
- 按 F5 或在“运行和调试”面板选择 Debug Spring Boot
- 在 Controller/Service 任意行设置断点，发起请求即可断点调试

## 其它说明
- 推荐使用 Postman/Swagger UI 测试接口
- 日志级别、端口等可在 application.properties 配置
- 代码已大量使用 Lombok 注解，需安装 Lombok 插件
- 支持多环境配置（dev/test/prod）

---

> 本项目适合 Spring Boot 入门、企业开发规范、调试技巧、API 设计等场景学习与复习。