快速开始
快速开始:十分钟本地跑通 eladmin 前后端
准备 JDK、MySQL、Redis,配置数据源,先后启动后端与前端,看到登录页并完成首次登录。附常见启动失败排查。
这篇把「从克隆代码到看到登录页」的完整路径走一遍。默认你本机已有 JDK 8/11、MySQL 5.7+、Redis、Node.js、Maven。
1. 准备数据库与 Redis
新建数据库 eladmin,字符集选 utf8mb4,导入仓库 sql/ 目录下的初始化脚本。Redis 本地启动即可,框架用它做缓存与验证码。
mysql -u root -p -e "CREATE DATABASE eladmin DEFAULT CHARACTER SET utf8mb4;"
mysql -u root -p eladmin < sql/eladmin.sql
redis-server
2. 配置后端
修改 eladmin-system/src/main/resources/config/application-dev.yml 里的数据源与 Redis 地址,重点核对 url、username、password 三项。
spring:
datasource:
url: jdbc:mysql://localhost:3306/eladmin?useUnicode=true&characterEncoding=utf8
username: root
password: your_password
redis:
host: localhost
port: 6379
3. 启动后端
在项目根目录执行打包并运行:
mvn clean package -DskipTests
java -jar eladmin-system/target/eladmin-system-*.jar
看到端口 8000 监听成功,说明后端就绪。
4. 启动前端
cd eladmin-web
npm install
npm run dev
浏览器打开终端提示的地址(默认 http://localhost:8080),默认账号密码 admin / 123456。
常见启动失败
- 连接数据库被拒:检查 MySQL 是否启动、账号权限与
application-dev.yml是否选中了 dev 环境。 - Redis 连接异常:确认 Redis 已启动,或注释掉相关配置临时排查。
- 前端白屏:多为 Node 版本过低,升级到 14+ 后重装依赖。
