Laravel+MySQL环境下文件名入库与存储失败问题排查求助

核心问题点 #

• 目录判断与磁盘路径不匹配：
  代码中用storage_path('FirewallRequest/'.$firewall->fw_number)判断目录是否存在，但创建目录用的是Storage::disk('fw_upload')->makeDirectory()，两者指向的路径大概率不一致（比如storage_path直接指向storage目录，而fw_upload磁盘通常配置在storage/app下），导致目录判断逻辑失效，可能出现目录未创建就尝试存文件的情况。

• 模型字段未开启批量赋值：
  如果ChangeManagementUploads模型未设置$fillable属性允许cm_number、filename、request_type字段写入，调用save()时数据库不会写入数据。

• 文件存储方式不规范：
  用File::get($filename)读取文件内容再存入，不如Laravel原生的putFileAs方法高效且不易出错，后者直接处理上传的文件实例。

• 循环逻辑冗余：
  while循环可以简化为foreach，更直观且避免手动维护计数器的失误。

• 表单字段配置问题：
  如果前端表单的文件上传字段name不是filename[]，$request->filename不会是数组，循环会直接出错。

修正后的代码示例 #

if ($request->hasFile('filename')) {
    $disk = Storage::disk('fw_upload');
    $directory = $firewall->fw_number;

    // 统一用磁盘方法判断目录是否存在并创建
    if (!$disk->exists($directory)) {
        $disk->makeDirectory($directory);
    }

    // 用foreach遍历上传的文件
    foreach ($request->file('filename') as $file) {
        $fwupload = new ChangeManagementUploads();
        $fwupload->cm_number = $firewall->fw_number;
        $fwupload->filename = $file->getClientOriginalName();
        $fwupload->request_type = $request->xtype;
        $fwupload->save();

        // 用putFileAs存储文件，自动处理文件流
        $disk->putFileAs($directory, $file, $file->getClientOriginalName());
    }
}

额外检查项 #

1. 文件系统磁盘配置：
   确认config/filesystems.php中fw_upload磁盘的配置正确，示例如下：

   'disks' => [
       // ...其他磁盘
       'fw_upload' => [
           'driver' => 'local',
           'root' => storage_path('app/FirewallRequest'),
           'throw' => false,
       ],
   ],
   

2. 模型填充配置：
   在ChangeManagementUploads模型中添加可填充字段：

   protected $fillable = ['cm_number', 'filename', 'request_type'];
   

3. 目录权限：
   确保storage/app/FirewallRequest目录的权限为755，且所属用户与Web服务器一致（如www-data），避免读写权限不足。
4. 前端表单设置：
   确保文件上传字段的name属性为filename[]，并添加multiple属性支持多文件上传：

   <input type="file" name="filename[]" multiple>
   

内容的提问来源于stack exchange，提问作者Teris2