owl admin 常见问题#

• 编辑 / 详情页面数据回显失败？提示 fetchFailed？#

  • 原因: 字段名存在 status 或 no , 与 amis 关键字冲突
    #4055: form 表单 initApi，服务端返回的 data 中包含 no、status 字段时，客户端处理异常

  • 解决方案:

    1. 更改字段名
    2. 使用 属性修改器
    3. 等待 amis 修复
• 图片 / 文件，回显失败#

  • 原因:
    默认的文件 / 图片上传处理方法，返回的文件路径不包含域名，导致回显失败
  • 解决方案:
    使用 属性修改器 :

    // 你的文件/图片字段
    public function image(): Attribute
    {
       return file_upload_handle();
    }Copy

• 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 --forceCopy

    • 使用 php artisan server 启动一下试试看，会不会出现同样的问题。如果没问题则证明属于浏览器缓存或者应用服务器的缓存问题。更换浏览器或者关闭浏览器即可。

    • 有一个版本更新改了框架布局文件，所以需要删除 admin_settings 表的数据，然后使用命令 php artisan cache:clear 清除缓存

• 宝塔面板 升级后 admin 包后，首页能展示，admin 页面可展示，logo 无显示，且 menu 等路由 404#

  • 示例图

    

  • 原因:
    大概率是 bt 执行 compser 是 root 用户，但是运行是 www 用户，目录权限的问题。

  • 解决方案

    • 先测试下别的路由，比如 url/hahah , 如果 app_debug 打开的话会有报错，根据提示修改即可，我这里是 bootstrap 目录权限出问题了，常规的目录权限问题还有 storage 等

欢迎大家的补充和指正，谢谢#

官方资源#

owl admin 文档
demo 地址
amis 所有组件示例