Laravel项目上传文件无法保存至指定文件夹问题求助

1. 检查表单的enctype属性 #

表单必须添加enctype="multipart/form-data"，否则文件数据根本不会被提交到后端。你的View中form标签需按如下写法：

<form method="POST" action="{{ route('你的路由名称') }}" enctype="multipart/form-data">
    @csrf
    <!-- 其他表单输入项 -->
    <input type="file" name="category_file"> <!-- 此处name需与Controller中获取的字段名一致 -->
    <button type="submit">提交</button>
</form>

漏加该属性会直接丢失文件数据，导致无法保存。

2. 确保目标文件夹权限足够 #

public/assets/upload/category路径必须给Web服务器（Apache/Nginx）开放写入权限：

• Linux/macOS终端执行命令：

chmod -R 755 public/assets/upload/category
chown -R www-data:www-data public/assets/upload/category

• Windows系统右键文件夹→属性→安全→给IIS_IUSRS或当前登录用户添加写入权限。
  权限不足会导致PHP无法写入文件，直接上传失败。

3. 修正Controller中的文件处理逻辑 #

需明确编写文件上传的处理代码，不能只处理数据库存储：

use Illuminate\Support\Facades\File;
use App\Models\Category;

public function store(Request $request)
{
    // 可选：验证文件合法性，避免无效上传
    $request->validate([
        'category_file' => 'required|file|mimes:jpg,png,jpeg,gif|max:2048',
    ]);

    if ($request->hasFile('category_file')) {
        $file = $request->file('category_file');
        // 生成唯一文件名，防止重名覆盖
        $fileName = time() . '_' . $file->getClientOriginalName();
        // 确认目标路径存在，不存在则自动创建
        $savePath = public_path('assets/upload/category');
        if (!File::exists($savePath)) {
            File::makeDirectory($savePath, 0755, true);
        }
        // 保存文件到目标路径
        $file->move($savePath, $fileName);

        // 将文件名与其他数据一同存入数据库
        Category::create([
            'name' => $request->name,
            'image' => $fileName, // 对应数据库中存储文件名的字段
            // 其他表单字段...
        ]);
    }

    return redirect()->back()->with('success', '提交成功');
}

注意事项：

• 使用public_path()拼接绝对路径，避免手动写路径出错
• 必须用$request->hasFile()判断文件是否存在，再执行保存操作
• 文件名建议添加时间戳，防止重名覆盖已有文件

4. 检查PHP上传配置限制 #

打开php.ini文件，确认以下参数设置合理：

• upload_max_filesize：设置为足够大的值（如2M，上传大文件需调大）
• post_max_size：必须大于upload_max_filesize的值
• max_execution_time：设置足够长的时间，避免上传过程超时
  修改完成后需重启Web服务器和PHP服务。

5. 确认CSRF令牌存在 #

Laravel默认验证CSRF令牌，表单中必须添加@csrf标签，否则请求会被拦截（虽然你提到数据能入库，但仍需确认该点）。

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