快速开始

快速开始:十分钟本地跑通 eladmin 前后端

准备 JDK、MySQL、Redis,配置数据源,先后启动后端与前端,看到登录页并完成首次登录。附常见启动失败排查。

约 3 分钟1003 字

这篇把「从克隆代码到看到登录页」的完整路径走一遍。默认你本机已有 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+ 后重装依赖。