Mojito 项目常见问题解决方案

Mojito 项目常见问题解决方案

mojito moell-peng/mojito:是一个开源的后台管理框架项目。特点：可能提供预设的管理功能模块、灵活的布局和主题定制选项，基于现代前端技术栈构建。适合：前端开发者、全栈开发者、需要快速构建后台管理系统的团队和个人。 项目地址: https://gitcode.com/gh_mirrors/moji/mojito

1. 项目基础介绍和主要编程语言

项目名称： Mojito

项目简介： Mojito 是一个基于 Laravel 和 Vue3 的后台管理系统，它实现了前后端分离，提供了基于 laravel-permission 的权限管理，以及基于 sanctum 的鉴权机制。项目旨在帮助开发者快速搭建后台管理系统，减少重复工作，提高开发效率。

主要编程语言： PHP (后端)、JavaScript (前端)

2. 新手使用时需特别注意的3个问题及解决步骤

问题一：安装项目后，无法正常执行迁移命令

问题描述： 安装项目后，执行 php artisan migrate 命令时出现错误。

解决步骤：

1. 确保已经正确安装了 Laravel 和相关依赖包。
2. 检查 .env 文件中的数据库配置是否正确。
3. 确认是否已经执行了 php artisan mojito:install 命令来发布迁移文件。
4. 如果仍然有问题，尝试删除 bootstrap/cache/config.php 文件，然后重新执行迁移命令。

问题二：无法登录后台

问题描述： 输入管理员账号密码后，无法登录后台。

解决步骤：

1. 检查配置文件 config/mojito.php 中的 guards 配置是否正确。
2. 确认数据库中是否存在管理员用户，并且状态为激活（status = 1）。
3. 检查路由中间件 mojito-permission 是否已经正确注册。
4. 如果使用 Vite 或其他前端构建工具，确保 CSRF token 配置正确。

问题三：前端页面加载不出来

问题描述： 前端页面无法正常加载，显示空白或错误。

解决步骤：

1. 检查前端构建工具（如 Vite）是否已正确配置。
2. 确认前端页面是否正确引用了资源文件。
3. 如果使用 Vite，确保 sanctum.php 中的 stateful 设置包含了前端页面的域名或IP地址。
4. 清除前端缓存，重新构建前端资源。

通过以上步骤，新手用户可以解决在开始使用 Mojito 项目时可能遇到的大部分常见问题。

mojito moell-peng/mojito:是一个开源的后台管理框架项目。特点：可能提供预设的管理功能模块、灵活的布局和主题定制选项，基于现代前端技术栈构建。适合：前端开发者、全栈开发者、需要快速构建后台管理系统的团队和个人。 项目地址: https://gitcode.com/gh_mirrors/moji/mojito