常见问题

owl-admin 新手入门 /

owl admin 常见问题

编辑 / 详情页面数据回显失败? 提示 fetchFailed？
- 原因: 字段名存在 status 或 no , 与 amis 关键字冲突
  #4055: form 表单 initApi，服务端返回的 data 中包含 no、status 字段时，客户端处理异常
- 解决方案:
  1. 更改字段名
  2. 使用 属性修改器
  3. 等待 amis 修复
图片 / 文件, 回显失败
- 原因:
  默认的文件/图片上传处理方法, 返回的文件路径不包含域名, 导致回显失败
- 解决方案:
  使用 属性修改器 :
```
// 你的文件/图片字段
public function image(): Attribute
{
   return file_upload_handle();
}
```
Status 组件, 设置 map / labelMap 属性后, 影响到其他 Status ?
- 原因:
  数据域污染
- 解决方案:
  暂无解决方案
  使用 status 组件时, 如果需要自定义 map / labelMap , 请用 mapping / tpl 代替
升级后页面白屏加载不出来
- 原因:
  数据缓存，浏览器缓存，资源未刷新等
- 解决方案:
  - 先查看是不是忘记执行资源更新了,有些版本是需要资源更新的，比如config lang assert views等
```
php artisan admin:publish --config --lang --assets --force
#如果你需要自行更改前端。则需要增加views 需要注意备份好自己修改的代码后再执行命令，这里会直接覆盖掉原有文件。
php artisan admin:publish --config --lang --assets --views --force
```
  - 使用 php artisan server启动一下试试看，会不会出现同样的问题。如果没问题则证明属于浏览器缓存或者应用服务器的缓存问题。更换浏览器或者关闭浏览器即可。
  - 有一个版本更新改了框架布局文件，所以需要删除 admin_settings 表的数据，然后使用命令 php artisan cache:clear 清除缓存
宝塔面板升级后 admin 包后，首页能展示，admin页面可展示，logo无显示，且menu等路由404
- 示例图
- 原因:
  大概率是bt执行compser是root用户，但是运行是www用户，目录权限的问题。
- 解决方案
  - 先测试下别的路由，比如 url/hahah ,如果 app_debug 打开的话会有报错，根据提示修改即可，我这里是 bootstrap 目录权限出问题了，常规的目录权限问题还有 storage 等