初次搭建ruoyi-vue-activiti踩过的坑

1,866 阅读4分钟

选择ruoyi-vue-activiti主要是它有工作流,在搭建过程中,遇到了一些问题,最后都一一解决。

搭建环境

  1. 系统:windows 10 64位
  2. IDEA版本:IntelliJ IDEA 2020.2.2 x64
  3. git地址:gitee.com/smell2/ruoy…
  4. 时间:2022-01-14

后台启动注意事项

  1. 先建数据库ruoyi-vue-activiti7,运行sql文件夹下的sql文件;修改ruoyi-admin下application-dev.yml文件中mysql数据库连接(数据库名称,数据库用户名和密码)。
  2. 安装redis并启动,redis默认端口6397不用修改,本机运行即可。
  3. 打开项目ruoyi-vue-activiti。maven依赖下载比较慢,可能需要多次刷新。
  4. 用启动类进行启动:在ruoyi-admin模块下src/main/com.ruoyi/RuoYiApplication

前端ruoyi-ui环境从零配置然后启动

一.配置前端Vue运行环境

(1)下载对应你系统的Node.js版本:nodejs.org/en/download…进行安装

这里有一个很严重的问题,初次安装浪费了很长时间,需要注意,第一次我安装的node.js是最新的版本,但是在项目上进行npm install的时候,会报错误无法安装下去。原因是node.js版本和node-sass版本不一致,以下是版本对应列表,这个需要特别注意,如果在vue项目上npm install依赖安装报错的话,回过头看看是不是这个问题。

NodeJSSupported node-sass versionNode Module
Node 155.0+88
Node 144.14+83
Node 134.13+,<5.079
Node 124.12+72
Node 114.10+,<5.067
Node 104.9+64
Node 114.5.3+,<5.057

2022年1月14日在ruoyi-ui中运行npm install的时候,现在node-sass默认安装的是4.14,这样需要先找到node.js14的版本进行安装,这个一定要注意。默认安装一定要注意,以后随着版本的升级默认安装的node-sass会随着版本的升级而变动

(2)node环境配置

      这里的环境配置主要配置的是npm安装的全局模块所在的路径,以及缓存cache的路径,之所以要配置,是因为以后在执行类似:npm install express -g (后面的可选参数-g,g代表global全局安装的意思)的安装语句时,会将安装的模块安装到【C:\Users\用户名\AppData\Roaming\npm】路径中,占C盘空间。

      在D:\Program Files\nodejs创建两个文件夹node_global和node_cache。打开cmd命令窗口,输入

npm config set prefix "D:\Program Files\nodejs\node_global"

npm config set cache "D:\Program Files\nodejs\node_cache"

在【系统变量】下新建【NODE_PATH】,输入【D:\Program Files\nodejs\node_global\node_modules】,将【用户变量】下的【Path】中的【C:\Users\用户\AppData\Roaming\npm】 修改为【D:\Program Files\nodejs\node_global】

(3)配置完测试,安装个module测试下,我们就安装最常用的express模块,打开cmd窗口,安装一个模块测试

npm install express -g

在这里遇到一个错误

npm ERR! code EPERM
npm ERR! syscall mkdir
npm ERR! path D:\Program Files\nodejs\node_cache\_cacache
npm ERR! errno -4048
npm ERR! Error: EPERM: operation not permitted, mkdir 'D:\Program Files\nodejs\node_cache\_cacache'
npm ERR!  [OperationalError: EPERM: operation not permitted, mkdir 'D:\Program Files\nodejs\node_cache\_cacache'] {
npm ERR!   cause: [Error: EPERM: operation not permitted, mkdir 'D:\Program Files\nodejs\node_cache\_cacache'] {
npm ERR!     errno: -4048,
npm ERR!     code: 'EPERM',
npm ERR!     syscall: 'mkdir',
npm ERR!     path: 'D:\\Program Files\\nodejs\\node_cache\\_cacache'
npm ERR!   },
npm ERR!   isOperational: true,
npm ERR!   errno: -4048,
npm ERR!   code: 'EPERM',
npm ERR!   syscall: 'mkdir',
npm ERR!   path: 'D:\\Program Files\\nodejs\\node_cache\\_cacache'
npm ERR! }
npm ERR!
npm ERR! The operation was rejected by your operating system.
npm ERR! It's possible that the file was already in use (by a text editor or antivirus),
npm ERR! or that you lack permissions to access it.
npm ERR!
npm ERR! If you believe this might be a permissions issue, please double-check the
npm ERR! permissions of the file and its containing directories, or try running
npm ERR! the command again as root/Administrator.

这个是文件夹权限问题,定位到nodejs文件夹,右键-属性进行修改文件夹权限。

安装vue环境vue.js

npm install vue -g

安装vue-router

npm install vue-router -g

安装vue脚支架

npm install vue-cli -g

(4)用idea打开项目,安装环境,启动项目

打开Terminal,进入ruoyi-ui,安装依赖,正常

npm install --registry=registry.npm.taobao.org

启动服务,正常无报错

npm run dev

可以正常访问访问了http://localhost:80/

第一次安装,遇到的是第一个问题就是node.js版本和node-sass版本不匹配导致其它依赖无法安装上,这里提醒一下,一定要去log日志文件中去查找定位问题,在Terminal展示出来的问题不一定是真正的根源问题,这个版本不匹配的问题在Terminal中未展示出来,展示的是gyp ERR! stack Error: Can't find Python executable "python", you can set the PYTHON env variable。在log文件中才能清楚的知道是node.js版本和node-sass版本不匹配。

启动成功后 Swagger UI访问路径 http://localhost/dev-api/swagger-ui.html