常见问题
怎么升级版本？
每次升级完最新版本后，请执行更新命令完成SQL语句升级 php bin/hyperf.php mine:update
菜单添加后页面不显示
一般是以下问题造成的：
- 组件路径地址错误，导致页面显示不出来
- 菜单代码标识重复，这个要保证全局唯一
- 菜单路由地址重复，这个要保证全局唯一
前端登录提示“未知错误”
一般是jwt私有密钥未初始化，执行下面两条命令进行初始化：
php bin/hyperf.php mine:jwt-gen --jwtSecret=JWT_SECRETphp bin/hyperf.php mine:jwt-gen --jwtSecret=JWT_API_SECRET
上传图片前端不显示
打开前端 config/upload.js，根据自己情况配置地址
// 文件存储URL地址
export default {
storage: {
LOCAL: 'http://127.0.0.1:9501',
OSS: '',
COS: '',
QINIU: ''
}
}
提示“队列相关功能未开启”
打开 App\System\Queue\Consumer\MessageConsumer.php 搜索文件 把 //#[Consumer...] 前面的 // 去掉
打开 App\System\Queue\Producer\MessageProducer.php 搜索文件 把 //#[Producer...] 前面的 // 去掉
登录后台白屏没有任何跳转
有以下几种可能，请逐一排查
数据库或者redis没有正确配置- 没有
真正的完成安装项目，需要再次运行php bin/hyperf mine:install命令 - 检查
.env文件的SUPER_ADMIN的值是否与用户表的超管ID一致 - 检查用户是否绑定了
角色，同时角色是否至少绑定了一个菜单 - 清除
Redis缓存
[系统监控]卡死
请使用root账户来启动项目。
为何出现“您访问的资源不存在”
- 确认是否配置了此菜单
- 确认后端路由定义是否存在，并检查是否需要参数
- 确认服务器是否重启
- 确认是否删除
runtime/container目录
超级管理员怎么设置
超级管理员，也就是创始人，必须在.env中的SUPER_ADMIN定义
docker里连不上数据库、Redis
这种情况一般是数据库和redis安装在本地（宿主机）
可使用以下命令查看本机ID地址
- Windows:
ipconfig - Linux:
ip addrorifconfig - Mac:
ifconfig
然后以局域网地址连接
或者使用Docker的专用地址：host.docker.internal
前端是否需要部署在docker里面？
不需要
安装的SQL文件在哪里？
MineAdmin没有使用传统SQL文件安装，而是使用了数据迁移工具进行建表和数据填充工作
相关的文件在每个模块下的Database里
前端一些页面不想缓存怎么操作
目前生成的vue页面里都有两个script标签，只需要删掉 export default { name: 'xxx' } 这行标签的代码即可不缓存
如何开启JWT多点登录
在后端 config/autoload/jwt.php 里找到下面这行，把 sso 改为 mpop 即可
'login_type' => env('JWT_LOGIN_TYPE', 'sso'), // 登录方式，sso为单点登录，mpop为多点登录
定时任务怎么不执行
一般发生在类任务，默认的 定时清理日志任务 由于在安装数据时 \ 被转义了，在后台看到的就是：
- AppSystemCrontabClearLogCrontab
而实际上应该是带有命名空间含义的类地址，带上斜杠后，系统就能找到这个类了。
- \App\System\Crontab\ClearLogCrontab
提示 SSL verify failed
一般多发生于宝塔用户
首先更新 libopenssl
- ubuntu/debian
sudo apt-get install libcurl4-openssl-dev
- centos/redhat
sudo yum install libcurl-devel
- alpine
apk add curl-dev