排查"无法创建根目录"错误​ 列印

症状​​

通过 WHMCS 发送邮件或访问 ​​工具 > 系统 > 系统清理​​ 时可能出现 "Oops" 错误页。

启用错误显示后可见：

League\Flysystem\Exception: 无法创建根目录 "/目录/路径"。位于 /path/to/whmcs/vendor/league/flysystem/src/Adapter/Local.php:106

⚠️ 此错误通常在迁移 WHMCS 安装位置后出现。

​​原因​​

邮件附件存储位置无法被读取或创建。即使发送的邮件不含附件，该路径也必须始终保持可访问。

​​解决方案​​

需验证存储设置配置：

1. 进入 ​​配置 > 系统设置 > 存储设置 > 配置​​ 选项卡

2. 点击每个存储位置旁的 ​​测试图标​​

    

   

3. 右上角显示测试结果：​​绿色成功​​ ​红色失败​​ 

    

   
   

4. 定位故障存储位置后，创建新路径并切换

    

   

5. 点击故障存储位置旁的 ​​复制图标​​ 复制图标

6. 指定正确的 WHMCS 附件目录路径

7. 点击 ​​保存更改​​ 保存弹窗
   

8. 页面刷新后新存储位置生效

9. 切换至 ​​设置​​ 选项卡

10. 在下列选项下拉菜单中选择新建的存储位置：

    • 客户文件

    • 邮件附件

    • 工单附件

11. 点击 ​​切换​​ 并确认 切换按钮

     
    

12. 对所有故障存储位置重复此流程

​​建议存储路径分配表​​

​​延伸阅读​​

存储设置文档| 迁移存储位置指南