3.6 KiB
常见问题
目录
- 一、后台相关
- 二、数据库相关
- 三、环境相关
一、后台相关
1、连接超时，请刷新重试。如仍未解决请检查websocket连接是否正确！
线上或非本地运行时，请到 系统设置 -> 配置管理 -> 基本设置 -> 找到网站域名和websocket地址，改成你自己实际的地址，保存刷新页面即可
2、web页面菜单切换后页面出现白屏
请参考：https://github.com/jekip/naive-ui-admin/issues/183
二、数据库相关
1、安装数据库出现 json 报错不支持
请安装 mysql5.7 及以上版本的数据库。如果你使用的是mariadb请确认版本号，mariadb从 10.2 版本开始支持 json 数据类型。
三、环境相关
1、not found in resource manager or following system searching paths
报错信息：panic: possible config files "config" or "config.toml/yaml/yml/json/ini/xml/properties" not found in resource manager or following system searching paths:
系统没有找到配置文件，将配置文件 manifest/config/config.yaml.bak 复制后改为manifest/config/config.yaml
2、net.DialTimeout failed with network
报错信息：connect to 127.0.0.1:8099 error: net.DialTimeout failed with network "tcp", address "127.0.0.1:8099", timeout "10s": dial tcp
- http服务没有启动或正在启动
- 通过一键启动所有服务运行时属正常情况，多服务启动时存在先后顺序问题，
tcpClient比tcpServer先启动完成导致的，等tcpServer启动完成后会自动重连
详细请参考 - 系统安装
3、cannot find "hack/config.yaml" in following paths:
报错信息：get cli configuration file:hack/config.yaml, err:cannot find "hack/config.yaml" in following paths:
系统运行目录下配置hack/config.yaml文件。如果是生产环境运行，并且不需要开发工具相关功能，可以将manifest/config/config.yaml配置文件中的system.mode值改为product，这样启动时不会加载开发工具相关功能
4、非超管角色提示：你没有访问权限！
此问题因当前角色访问的页面包含未分配权限的接口所致，在多角色场景中较为常见，解决步骤如下：
- 定位缺失权限的接口
- 用超管账号进入系统应用 -> 日志管理 -> 全局日志，搜索状态码为
62 无访问权限的记录 - 示例：若请求接口为
/admin/hgexample/treeTable/list，需处理的权限路径为/hgexample/treeTable/list（去除/admin前缀）
假如查到请求接口是：/admin/hgexample/treeTable/list，那需要分配的菜单权限就是：/hgexample/treeTable/list,要把/admin去掉
- 配置菜单权限
- 进入权限管理 -> 菜单权限：
- 若目标菜单不存在，先新增菜单
- 若菜单已存在但未配置接口权限，就把步骤1中的权限路径添加到【分配权限】中（已配置则跳过）
- 分配权限给角色
- 进入权限管理 -> 角色权限，找到对应角色并点击【菜单权限】
- 勾选步骤2中配置的菜单权限，保存即可
四、前端相关
1、Error: connect ECONNREFUSED ::1:8000
11:44:52 [vite] http proxy error at /member/info:
Error: connect ECONNREFUSED ::1:8000
at TCPConnectWrap.afterConnect [as oncomplete] (node:net:1246:16)
- 服务端没有启动
.\wen\.env.development中的VITE_PROXY配置的服务器地址或端口与实际不一致