常见问题

怎么升级版本?

每次升级完最新版本后,请执行更新命令完成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的专用地址:docker.host.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为多点登录