# 常见问题

# 怎么升级版本?

每次升级完最新版本后,请执行更新命令完成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/index.js,根据自己情况配置地址

// 文件存储URL地址
STORAGE_URL: {
    LOCAL: 'http://127.0.0.1:9501',
    OSS: '',
    COS: '',
    QINIU: ''
}
1
2
3
4
5
6
7

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

打开 App\System\Queue\Consumer\MessageConsumer.php 搜索文件 把 #Consumer 替换成 @Consumer

打开 App\System\Queue\Producer\MessageProducer.php 搜索文件 把 #Producer 替换成 @Producer

# 浏览器报错Invalid Host header

vue.config.js里如下所示增加代码。

devServer: {
    disableHostCheck: true,
}
1
2
3

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

有以下几种可能,请逐一排查

  • 数据库 或者 redis 没有正确配置
  • 没有真正的完成安装项目,需要再次运行 php bin/hyperf mine:install 命令
  • 检查.env文件的SUPER_ADMIN的值是否与用户表的超管ID一致
  • 检查用户是否绑定了角色,同时角色是否至少绑定了一个菜单
  • 清除Redis缓存

# [系统监控]和[依赖监控]卡死

因为使用root账户启动的项目,composer命令也是以root身份去运行的。

composer在以root身份运行会在控制台提示输入yes OR no造成阻塞导致卡死。

请使用非root账户来启动项目。

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

  • 确认是否配置了此菜单
  • 确认后端路由定义是否存在,并检查是否需要参数
  • 确认服务器是否重启
  • 确认是否删除 runtime/container 目录

# 超级管理员怎么设置

超级管理员,也就是创始人,必须在.env中的SUPER_ADMIN定义

# docker里连不上数据库、Redis

这种情况一般是数据库redis安装在本地(宿主机)

可使用以下命令查看本机ID地址

  • Windows: ipconfig
  • Linux: ip addr or ifconfig
  • Mac: ifconfig

然后以局域网地址连接

或者使用Docker的专用地址:docker.host.internal

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

不需要

# 为什么安装要执行两遍 mine:install

一、第一次执行命令是为了生成.env文件。

二、因为常驻内存,.env 文件此时还未加载,数据库、redis等还无法使用,所以需要重启加载加.env文件。

三、重启后,再次执行安装命令是为了执行migrate和seeds

# 安装的SQL文件在哪里?

MineAdmin没有使用传统SQL文件安装,而是使用了数据迁移工具进行建表和数据填充工作

相关的文件在每个模块下的Database