---
title: 项目运行
prev: false
# next: ./backend
---

## 后端
::: tip 请确认您已有以下运行环境
1. JDK 1.8 及以上
2. Maven 版需要安装 Maven 3.6.3 及以上，Gradle 版无需安装 Maven 及 Gradle
:::

::: warning 另外您还需要安装以下中间件并启动
1. MySQL 5.6.x 及以上
2. Redis 3.x 及以上
:::

### 1、数据库
* 在 `MySQL` 中创建数据库：`ry-vue`
  ![mysql](../../.vuepress/public/boot/mysql.png)
* 向数据库`ry-vue`中导入表：ruoyi-solon/sql/ry-vue.sql
* 修改项目中的数据库连接配置：ruoyi-solon/ruoyi-admin/src/main/resources/app-dev.yml
  ```yaml {6-8}
  # Redis配置
  redis:
    cache_source:
      config: |
        singleServerConfig:
          address: redis://127.0.0.1:6379
          password:
          database: 7
  ```
  > 请确保 Redis 指定库中没有缓存数据
  ```yaml {8-10}
  # mybatis-flex 数据源及 mybatis配置
  mybatis-flex:
    # 动态数据源
    datasource:
      master:
        type: com.zaxxer.hikari.HikariDataSource
        driverClassName: com.mysql.cj.jdbc.Driver
        jdbcUrl: jdbc:mysql://127.0.0.1:3306/ry-vue?useUnicode=true&characterEncoding=utf8&autoReconnect=true&rewriteBatchedStatements=true
        username: root
        password:
  ```
  ::: warning 注意
  您还需要配置`quartz定时任务持久化`：  
  ruoyi-solon/ruoyi-admin/src/main/resources/quartz.properties  
  配置为和`app-dev.yml`中同一个数据库即可。
  :::
  ```yaml {4-6}
  # quartz定时任务持久化配置
  org.quartz.dataSource.ryDS.provider=hikaricp
  org.quartz.dataSource.ryDS.driver=com.mysql.cj.jdbc.Driver
  org.quartz.dataSource.ryDS.URL=jdbc:mysql://127.0.0.1:3306/ry-vue?useUnicode=true&zeroDateTimeBehavior=convertToNull&autoReconnect=true
  org.quartz.dataSource.ryDS.user=root
  org.quartz.dataSource.ryDS.password=
  ```

### 2、运行后端
* 使用`IDEA`打开`ruoyi-solon`，启动：
  * ruoyi-solon/ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication
::: warning 注意
如果是`Gradle`版，并且您的`IDEA`版本较旧（比如`2018.3`版），启动后访问系统可能会报错：
> Error querying database. Cause: org.apache.ibatis.binding.BindingException: Parameter 'userName' not found.

这是由于`Gradle`版本与`IDEA`版本兼容性导致的编译参数`-parameters`没生效。\
您需要在`File -> Settings -> Build,Execution,Deployment -> Compiler -> Java Compiler`中的`Javac Options`下的`Additional command line parameters`中添加`-parameters`。

![gradle_settings](../../.vuepress/public/boot/gradle_settings.png)
添加后`clean`，重新编译。

`IDEA`推荐使用`2021.3`及以上版本。
:::

## 前端
::: tip 请确认您已有以下运行环境
1. Node.js 14.x 及以上
:::

### 1、运行前端
```bash
# 进入前端项目目录，在终端中运行命令
cd ruoyi-solon-ui
# cd ruoyi-solon-ui-vue3

# 安装依赖
npm install

# 建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过指定镜像源解决 npm 下载速度慢的问题
# npm install --registry=https://registry.npmmirror.com

# 启动服务
npm run dev
```

浏览器访问 http://localhost:80
