RuoYi-WMS-VUE 常见问题解决方案

RuoYi-WMS-VUE 常见问题解决方案

RuoYi-WMS-VUE 若依wms是一套基于若依的wms仓库管理系统，支持lodop和网页打印入库单、出库单。包括仓库/库区/货架管理，出入库管理，客户/供应商/承运商，库存看板、库存记录等功能。 项目地址: https://gitcode.com/gh_mirrors/ru/RuoYi-WMS-VUE

项目基础介绍

RuoYi-WMS-VUE 是一套基于若依框架的仓库管理系统，支持 LODOP 和网页直接打印功能，能够生成入库单、出库单等重要文档。该项目主要使用 Vue3、Element Plus 和 Vite 作为前端技术栈，后端项目地址为 gitee地址 和 github地址。

新手使用注意事项及解决方案

1. 依赖安装问题

问题描述：在执行 npm install 或 yarn install 时，可能会遇到依赖安装失败的情况。

解决步骤：

1. 检查网络连接：确保你的网络连接正常，能够访问 npm 或 yarn 的官方仓库。
2. 使用镜像源：如果网络连接正常但仍然安装失败，可以尝试使用国内的镜像源，例如：

   npm install --registry=https://registry.npmmirror.com
   

3. 清理缓存：有时缓存问题也会导致安装失败，可以尝试清理 npm 或 yarn 的缓存：

   npm cache clean --force
   yarn cache clean
   

2. 启动服务失败

问题描述：在执行 npm run dev 或 yarn dev 时，服务无法正常启动。

解决步骤：

1. 检查端口占用：确保端口 80 未被其他应用占用，可以使用以下命令检查端口占用情况：

   lsof -i :80
   

   如果端口被占用，可以尝试修改项目的端口配置，或者关闭占用端口的进程。
2. 检查依赖安装：确保所有依赖已经正确安装，可以尝试重新安装依赖：

   npm install
   

3. 查看错误日志：如果服务启动失败，查看控制台输出的错误日志，根据错误信息进行排查。

3. 构建环境配置问题

问题描述：在执行 yarn build:stage 或 yarn build:prod 时，构建失败或生成的文件不符合预期。

解决步骤：

1. 检查环境配置：确保 .env.development 和 .env.production 文件中的环境变量配置正确。
2. 清理构建缓存：有时构建缓存会导致构建结果不符合预期，可以尝试清理构建缓存：

   rm -rf node_modules/.cache
   

3. 检查依赖版本：确保所有依赖的版本与项目要求一致，可以查看 package.json 文件中的版本要求，并使用 npm install 或 yarn install 重新安装依赖。

通过以上步骤，新手用户可以更好地解决在使用 RuoYi-WMS-VUE 项目时遇到的一些常见问题。

RuoYi-WMS-VUE 若依wms是一套基于若依的wms仓库管理系统，支持lodop和网页打印入库单、出库单。包括仓库/库区/货架管理，出入库管理，客户/供应商/承运商，库存看板、库存记录等功能。 项目地址: https://gitcode.com/gh_mirrors/ru/RuoYi-WMS-VUE