常见问题

怎么升级版本？

每次升级完最新版本后，请执行更新命令完成SQL语句升级 php bin/hyperf.php mine:update

菜单添加后页面不显示

一般是以下问题造成的：

组件路径地址错误，导致页面显示不出来
菜单代码标识重复，这个要保证全局唯一
菜单路由地址重复，这个要保证全局唯一

前端登录提示“未知错误”

一般是jwt私有密钥未初始化，执行下面两条命令进行初始化：

php bin/hyperf.php mine:jwt-gen --jwtSecret=JWT_SECRET
php 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 addr or ifconfig
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为多点登录

# 常见问题

# 怎么升级版本？

# 菜单添加后页面不显示

# 前端登录提示“未知错误”

# 上传图片前端不显示

# 提示“队列相关功能未开启”

# 登录后台白屏没有任何跳转

# [系统监控]卡死

# 为何出现“您访问的资源不存在”

# 超级管理员怎么设置

# docker里连不上数据库、Redis

# 前端是否需要部署在docker里面？

# 安装的SQL文件在哪里？

# 前端一些页面不想缓存怎么操作

# 如何开启JWT多点登录