Laravel图片上传异常：文件存tmp未到指定目录且未入库

一、检查表单enctype属性 #

确保上传图片的表单添加enctype="multipart/form-data"，否则文件无法正确传递到后端：

<form method="POST" action="{{ route('projects.store') }}" enctype="multipart/form-data">
    @csrf
    <!-- 其他表单字段 -->
    <input type="file" name="project_image">
    <button type="submit">提交</button>
</form>

二、控制器中正确处理文件存储 #

在ProjectController的store/update方法中，必须调用文件的store()或storeAs()方法，将文件从tmp目录移动到目标存储位置，同时将路径存入数据库：

public function store(Request $request)
{
    $validated = $request->validate([
        'project_image' => 'required|image|max:2048', // 根据需求调整验证规则
        // 其他字段验证规则
    ]);

    // 存储文件到public磁盘的projects目录下
    if ($request->hasFile('project_image')) {
        $imagePath = $request->file('project_image')->store('projects', 'public');
        $validated['image'] = $imagePath; // 替换为你的模型中存储图片路径的字段名
    }

    Project::create($validated);

    return redirect()->route('projects.index')->with('success', '项目创建成功');
}

若需自定义文件名，可使用storeAs()：

$imageName = uniqid() . '.' . $request->file('project_image')->getClientOriginalExtension();
$imagePath = $request->file('project_image')->storeAs('projects', $imageName, 'public');

三、验证模型的Fillable属性 #

确保Project模型中存储图片路径的字段（如image）在$fillable数组内，否则无法通过create()/update()写入数据库：

class Project extends Model
{
    use HasFactory;

    protected $fillable = [
        'name', // 其他业务字段
        'image', // 图片路径字段必须在此处
    ];
}

四、检查存储配置与目录权限 #

1. 确认config/filesystems.php中public磁盘配置正确：

'public' => [
    'driver' => 'local',
    'root' => storage_path('app/public'),
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
],

2. 确保目录有写入权限，执行命令：

chmod -R 755 storage/ public/
chown -R www-data:www-data storage/ public/ # 服务器用户需对应，Mac可替换为_www:_www

3. 重新创建存储软链接：

php artisan storage:link

若命令创建失败，可手动创建：

• Linux/Mac：ln -s /项目绝对路径/storage/app/public /项目绝对路径/public/storage
• Windows（命令提示符）：mklink /D public\storage storage\app\public

五、调试排查 #

若以上步骤无效，添加调试代码定位问题：

public function store(Request $request)
{
    // 查看文件上传状态
    dd($request->file('project_image'));
    // 或写入日志
    \Log::info('上传文件信息:', ['name' => $request->file('project_image')?->getClientOriginalName()]);
}

查看storage/logs/laravel.log中的错误信息，定位具体异常。

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