快速开始

当你第一次拉取项目、或准备把它跑起来与前端联调时，从这里开始。

本指南帮助你在 5 分钟内 完成后端服务 youlai-boot（Java/Spring Boot）的启动与验证，你将完成：

• 导入数据库初始化脚本
• 配置本地 MySQL / Redis
• 启动服务并访问 /doc.html
• 使用默认账号完成一次登录验证

前置条件

必需环境：

环境	版本要求	下载地址
JDK	17+	Adoptium
Maven	3.6+	Maven官网
MySQL	5.7+ / 8.x	安装教程
Redis	7.x	安装教程

开发工具（可选）：

• IntelliJ IDEA（推荐）
• Visual Studio Code

项目结构

youlai-boot/
├── deploy/
│   └── docker/               # Docker 编排
├── sql/
│   └── youlai-admin.sql      # 初始化脚本
├── src/
│   └── main/
│       ├── java/             # 源代码
│       └── resources/
│           ├── application.yml              # 主配置
│           ├── application-dev.yml          # 开发环境配置
│           └── application-prod.yml         # 生产环境配置
├── pom.xml                   # Maven依赖
└── README.md

安装步骤

数据库初始化

执行数据库脚本：

mysql -u root -p < sql/youlai-admin.sql

或通过数据库管理工具导入 sql/youlai-admin.sql。

配置修改

修改 src/main/resources/application-dev.yml：

数据库配置：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/youlai_admin?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
    username: root
    password: your_password

Redis配置：

spring:
  data:
    redis:
      host: localhost
      port: 6379
      password: # 如有密码则填写

服务端口：

server:
  port: 8000

启动服务

IDE 方式：

运行启动类：src/main/java/com/youlai/boot/YouLaiBootApplication.java

命令行方式：

mvn clean install
mvn spring-boot:run

启动成功标志：

Started YouLaiBootApplication in 3.456 seconds

快速验证

接口文档

访问 Swagger 文档：

http://localhost:8000/doc.html

登录测试

使用 Swagger 或 curl 测试登录接口：

curl -X POST http://localhost:8000/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"123456"}'

成功响应：

{
  "code": "00000",
  "msg": "成功",
  "data": {
    "accessToken": "eyJhbGc...",
    "refreshToken": "eyJhbGc...",
    "tokenType": "Bearer",
    "expiresIn": 3600
  }
}

前端联调

克隆前端项目

git clone https://gitee.com/youlaiorg/vue3-element-admin.git
cd vue3-element-admin

配置后端地址

修改 .env.development：

VITE_APP_API_URL=http://localhost:8000

启动前端

pnpm install
pnpm run dev

访问 http://localhost:3000，使用以下账号登录：

• 用户名：admin
• 密码：123456

常见问题

端口冲突

错误信息：Port 8000 already in use

解决方案：修改 application-dev.yml 中的 server.port

数据库连接失败

错误信息：Communications link failure

排查步骤：

1. 确认 MySQL 服务已启动
2. 检查数据库连接配置（地址、端口、用户名、密码）
3. 确认数据库 youlai_admin 已创建

Redis 连接失败

错误信息：Unable to connect to Redis

排查步骤：

1. 确认 Redis 服务已启动：redis-cli ping
2. 检查 Redis 连接配置
3. 如有密码，确认密码正确

下一步

• 部署运维 - 生产环境部署指南
• 配置说明 - 详细配置参数
• 认证机制 - 登录认证与会话管理
• 数据权限 - 数据权限配置