快速开始
本指南帮助您在 5 分钟内 完成后端服务 youlai-aspnet（.NET 8 / ASP.NET Core 8）的启动和验证。
前置条件
必需环境：
| 环境 | 版本要求 | 下载地址 |
|---|---|---|
| .NET SDK | 8.0.416+ | 下载地址 |
| MySQL | 5.7+ / 8.x | 安装教程 |
| Redis | 7.x | 安装教程 |
开发工具（可选）：
- Visual Studio 2022（推荐）
- Visual Studio Code + C# Dev Kit
- JetBrains Rider
项目结构
youlai-aspnet/
├── sql/ # 数据库脚本
│ └── mysql/
│ └── youlai_admin.sql # 初始化脚本
├── src/
│ ├── Youlai.Api/ # Web API 入口
│ ├── Youlai.Application/ # 应用层
│ ├── Youlai.Domain/ # 领域层
│ └── Youlai.Infrastructure/# 基础设施层
├── tests/ # 测试项目
├── youlai-aspnet.sln # 解决方案文件
└── global.json # SDK 版本锁定安装步骤
数据库初始化
执行数据库脚本：
bash
mysql -u root -p < sql/mysql/youlai_admin.sql或通过数据库管理工具导入 sql/mysql/youlai_admin.sql。
配置修改
修改 src/Youlai.Api/appsettings.Development.json：
数据库配置：
json
"Database": {
"ConnectionString": "Server=localhost;Port=3306;Database=youlai_admin;User=root;Password=your_password;"
}Redis配置：
json
"Redis": {
"ConnectionString": "localhost:6379,password=,defaultDatabase=0"
}JWT配置：
json
"Security": {
"Session": {
"Jwt": {
"SecretKey": "your-secret-key-at-least-32-characters-long"
}
}
}启动服务
Visual Studio 方式：
打开 youlai-aspnet.sln，设置 Youlai.Api 为启动项目，按 F5 运行。
命令行方式：
bash
dotnet restore
dotnet run --project src/Youlai.Api启动成功标志：
Now listening on: http://localhost:8000快速验证
接口文档
访问 Swagger 文档：
http://localhost:8000/swagger登录测试
使用 Swagger 或 curl 测试登录接口：
bash
curl -X POST http://localhost:8000/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"123456","captchaId":"test","captchaCode":"1234"}'成功响应：
json
{
"code": "00000",
"msg": "成功",
"data": {
"accessToken": "eyJhbGc...",
"refreshToken": "eyJhbGc...",
"tokenType": "Bearer",
"expiresIn": 7200
}
}前端联调
克隆前端项目
bash
git clone https://gitee.com/youlaiorg/vue3-element-admin.git
cd vue3-element-admin配置后端地址
修改 .env.development：
env
VITE_APP_API_URL=http://localhost:8000启动前端
bash
pnpm install
pnpm run dev访问 http://localhost:5173，使用以下账号登录：
- 用户名：
admin - 密码：
123456
常见问题
端口冲突
错误信息：Address already in use
解决方案：修改 appsettings.Development.json 中的 Kestrel:Endpoints:Http:Url
数据库连接失败
错误信息：Unable to connect to MySQL server
排查步骤：
- 确认 MySQL 服务已启动
- 检查数据库连接配置（地址、端口、用户名、密码）
- 确认数据库
youlai_admin已创建
Redis 连接失败
错误信息：It was not possible to connect to the redis server
排查步骤：
- 确认 Redis 服务已启动：
redis-cli ping - 检查 Redis 连接配置
- 如有密码，确认密码正确