# springboot3-template

**Repository Path**: ggxx/springboot3-template

## Basic Information

- **Project Name**: springboot3-template
- **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-12-15
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: java-web, 脚手架

## README

# Spring Boot 3 Backend Template

精简后的通用模板，只保留基础设施（Web、校验、JWT 辅助类、统一返回、CORS、Swagger、Redis、MyBatis Plus 配置）， 便于在此基础上开发自己的项目。

## 技术栈
- Java 21、Spring Boot 3.5.0
- MyBatis Plus 3.5.12 + MySQL（Druid 连接池）
- Redis（spring-boot-starter-data-redis）
- JWT（jjwt 0.12.3）辅助类
- Springdoc OpenAPI 2.5.0
- Hutool、Lombok、Fastjson

## 目录概览
- `src/main/java/com/android1s/Application.java` — 启动类
- `common/Result.java` — 统一返回封装
- `common/JwtUtils.java` — JWT 生成/校验工具
- `config/` — CORS、JWT 拦截器、WebMvc、Redis、MyBatis Plus、Swagger 等通用配置
- `resources/application.yml` — 基础配置示例（数据库/Redis/JWT/Swagger）

已删除：
- 业务实体/Service/Controller/Mapper/XML
- MobileIMSDK 相关管理与监听代码
- 语音/文件上传、消息、用户等领域实现

## 快速开始
1) 修改 `src/main/resources/application.yml`，替换数据库、Redis、JWT 密钥等占位符。  
2) 构建 & 运行：
```bash
mvn clean package
mvn spring-boot:run
```
访问 Swagger 文档：`http://localhost:8080/swagger-ui.html`

## 开发指引
- 在 `controller/service/entity/mapper` 下新增自己的业务模块，沿用统一返回 `Result` 与拦截器。  
- 如需数据库表初始化，可自行接入 Flyway/Liquibase。  
- 需要安全框架时，可按需添加 Spring Security。  
- Maven 编译器已设置为 Java 21（与 Spring Boot 3 要求一致）。