Laravel+Filament线上服务器文件上传失效问题求助

针对你的Laravel+Filament文件上传线上失效问题，结合实际开发经验给出以下排查方向和解决方法：

1. 确认磁盘配置与目录权限细节 #

• 检查config/filesystems.php中local磁盘的root路径，确认线上服务器的storage/app目录与本地一致，且**form-attachments子目录已存在**。Filament理论上会自动创建目录，但部分服务器的umask设置可能导致创建失败，建议手动在服务器执行：

  mkdir -p storage/app/form-attachments
  chmod 755 storage/app/form-attachments
  chown www-data:www-data storage/app/form-attachments # 根据服务器web用户调整
  

• 再次验证权限链：storage→app→form-attachments都需要web服务器用户（如nginx、apache）拥有写入权限。

2. 切换磁盘测试，排除配置问题 #

暂时将组件切换到public磁盘测试，同时确保执行存储链接命令：

FileUpload::make('attachment')
  ->disk('public')
  ->directory('form-attachments')
  ->visibility('public');

执行线上命令：

php artisan storage:link

如果切换后能正常上传，说明原local磁盘的权限或可见性配置存在隐性问题，可针对性调整local磁盘权限或改用public磁盘配合业务权限控制。

3. 查看Laravel日志挖掘隐性错误 #

控制台和网络面板无报错不代表后端无异常，直接查看storage/logs/laravel.log，搜索file、upload、write等关键词，大概率能找到文件写入失败、权限不足、磁盘路径错误等细节。

4. 检查服务器上传大小限制 #

• 查看服务器php.ini中的upload_max_filesize和post_max_size参数，确保值足够大（比如设置为10M），部分服务商默认值过小会导致大文件静默上传失败。
• 可在Filament组件中临时限制小文件测试：

  FileUpload::make('attachment')
    ->disk('local')
    ->directory('form-attachments')
    ->visibility('private')
    ->maxSize(1024); // 限制1MB以内的文件
  

5. 剥离Filament测试原生上传 #

写一个极简的Laravel原生上传接口，验证基础上传功能是否正常：

// routes/web.php
use Illuminate\Http\Request;

Route::post('/test-upload', function (Request $request) {
    $request->validate(['file' => 'required|file']);
    
    try {
        $path = $request->file('file')->store('form-attachments', 'local');
        return response()->json(['success' => true, 'path' => $path]);
    } catch (\Exception $e) {
        return response()->json(['success' => false, 'error' => $e->getMessage()], 500);
    }
});

用Postman或表单提交文件测试，如果这个接口也失败，问题出在Laravel与服务器配置；如果成功，则排查Filament组件的版本兼容或前端逻辑。

6. 排查Filament版本与前端细节 #

• 确认Filament版本与Laravel版本兼容（如Laravel 10对应Filament v3.x），版本不匹配可能导致隐性bug。
• 开启浏览器控制台的Verbose日志级别，查看Filament上传组件的前端请求细节，是否存在隐藏的请求失败或组件渲染异常。

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