Plumemo 后端管理系统常见问题解决方案

夏磊讳

于 2024-12-21 09:41:00 发布

阅读量559

点赞数 25

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00584/article/details/144625548

Plumemo 后端管理系统常见问题解决方案

plumemo-admin plumemo 后端管理系统项目地址: https://gitcode.com/gh_mirrors/pl/plumemo-admin

项目基础介绍

Plumemo 是一个轻量、易用、前后端分离的博客系统，旨在解除开发人员对后端的束缚，真正做到面向接口开发的博客系统。该项目基于 SpringBoot 实现零配置，使用了 Mybatis-Plus 快速开发框架，简化了复杂的查询操作，无需编写 SQL 即可快速完成接口编写。后台管理系统使用了 Vue 中流行的 Ant Design 组件库，前后交互使用了 JWT 作为令牌进行权限和登录校验。

主要的编程语言包括：

Java：用于后端逻辑和接口开发。
Vue.js：用于前端页面和交互逻辑的开发。
JavaScript：用于前端脚本和配置文件。

新手使用项目时需要注意的3个问题及解决步骤

1. 项目依赖安装失败

问题描述：新手在克隆项目后，执行 npm install 命令时，可能会遇到依赖安装失败的问题，通常是由于网络问题或依赖包版本不兼容导致的。

解决步骤：

检查网络连接：确保网络连接正常，可以尝试使用国内的 npm 镜像源，例如淘宝镜像源：
```
npm install --registry=https://registry.npm.taobao.org
```
清理缓存：如果依赖安装失败，可以尝试清理 npm 缓存：
```
npm cache clean --force
```
检查依赖版本：确保项目中的 package.json 文件中的依赖版本与当前安装的 npm 版本兼容。如果不确定，可以尝试更新 npm 版本：
```
npm install -g npm
```

2. 后端管理系统启动失败

问题描述：在执行 vue-cli-service serve 命令启动后端管理系统时，可能会遇到启动失败的问题，通常是由于环境配置不正确或端口被占用导致的。

解决步骤：

检查环境配置：确保项目根目录下的 .env 文件配置正确，特别是 VUE_APP_BASE_API 和 VUE_APP_BASE_URL 等环境变量。
检查端口占用：如果端口被占用，可以尝试修改 vue.config.js 文件中的 devServer 配置，更换端口号：
```
devServer: {
    port: 8081, // 更换为其他端口号
}
```
重新启动：在修改配置后，重新执行 vue-cli-service serve 命令启动项目。

3. JWT 令牌校验失败

问题描述：在使用 JWT 进行权限校验时，可能会遇到令牌校验失败的问题，通常是由于令牌生成或解析不正确导致的。

解决步骤：

检查 JWT 配置：确保后端项目中的 application.yml 或 application.properties 文件中，JWT 的相关配置正确，特别是 jwt.secret 和 jwt.expiration 等参数。
检查令牌生成逻辑：确保前端在登录成功后，正确生成了 JWT 令牌，并将其存储在 localStorage 或 sessionStorage 中。
检查令牌解析逻辑：确保后端在接收到请求时，正确解析了 JWT 令牌，并验证了令牌的有效性。如果解析失败，可以尝试重新生成令牌或检查令牌的签名是否正确。