Django-Vue-Admin-Pro 常见问题解决方案

Django-Vue-Admin-Pro 常见问题解决方案

项目基础介绍

Django-Vue-Admin-Pro 是一套全部开源的快速开发平台，旨在帮助开发者快速构建企业级后台管理系统。该项目前端采用 D2Admin 和 Vue.js，后端采用 Python 语言的 Django 框架。权限认证使用 Jwt，支持多终端认证系统，并支持加载动态权限菜单，多方式轻松权限控制。

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

1. 环境配置问题

问题描述：新手在配置开发环境时，可能会遇到依赖安装失败或版本不兼容的问题。

解决步骤：

1. 检查 Python 版本：确保你的 Python 版本在 3.6 以上。
2. 安装依赖：

   cd backend
   pip3 install -r requirements.txt
   

3. 配置数据库：
   • 复制 /conf/env.example.py 文件为 /conf/env.py。
   • 在 env.py 中配置数据库信息，建议使用 MySQL 8.0 版本，字符集设置为 utf8mb4。

2. 前端项目启动问题

问题描述：前端项目启动时，可能会遇到端口冲突或依赖安装失败的问题。

解决步骤：

1. 克隆项目：

   git clone https://github.com/dvadmin-pro/django-vue-admin-pro.git
   cd web
   

2. 安装依赖：

   npm install --registry=https://registry.npm.taobao.org
   

3. 启动服务：

   npm run dev
   

4. 检查端口：如果端口冲突，可以在 .env.development 文件中修改启动端口。

3. 后端接口访问问题

问题描述：新手在启动后端服务后，可能会遇到接口无法访问或权限认证失败的问题。

解决步骤：

1. 启动后端服务：

   cd backend
   python3 manage.py runserver 127.0.0.1:8000
   

2. 初始化数据：

   python3 manage.py makemigrations
   python3 manage.py migrate
   python3 manage.py init
   

3. 检查接口文档：访问 http://127.0.0.1:8000/swagger 查看接口文档，确保接口正常运行。
4. 权限认证：使用初始账号 superadmin 和密码 admin123456 进行登录，确保权限认证系统正常工作。

通过以上步骤，新手可以顺利解决在使用 Django-Vue-Admin-Pro 项目时遇到的一些常见问题。