Laravel使用$file->move()上传图片报错：不支持的操作数类型

AI 小北

2026-7-11

图片上传函数「Unsupported operand types」异常排查与修复

问题代码

public function uploadImage($file, $path) {
    $filename = Str::random(6) . '_' . time() . '_' . $file->getClientOriginalName();
    $uploads_folder = public_path() . $path;
    if (!file_exists($uploads_folder)) {
        mkdir($uploads_folder, 0777, true);
    }
    $image = $path . "/" . $filename;

    $file->move($uploads_folder, $filename);
    return $image;
}

问题描述

该函数此前运行正常，近期出现「Unsupported operand types」异常，文件已成功保存至目标文件夹，但未执行return语句。

排查与解决方案

「Unsupported operand types」错误通常是对非数值类型执行了算术运算（如+、-），结合文件已成功保存的现象，可从以下方向排查：

检查调用上下文的算术操作：文件保存成功说明函数核心逻辑正常，异常大概率来自函数外部——比如调用代码对返回的字符串$image执行了算术运算（如$image + 50）。找到这类代码，将算术操作替换为适合字符串的处理逻辑，或确保操作数为数值类型。
校验$path参数类型：若调用时传入的$path是数组而非字符串，虽然可能因某些巧合完成文件保存，但字符串与数组拼接会触发类型错误。建议在函数开头添加参数校验：
```
if (!is_string($path)) {
    throw new \InvalidArgumentException('参数$path必须为字符串类型');
}
```
确认Str类未被覆盖：若项目中存在同名变量或类覆盖了Illuminate\Support\Str，会导致Str::random()行为异常。可临时添加调试代码验证：
```
dd(get_class(\Illuminate\Support\Str::class)); // 应输出Illuminate\Support\Str
```
强制转换数值类型为字符串：虽然time()返回整数，但极端环境下可能出现类型转换问题，可强制转为字符串避免拼接时的隐式转换异常：
```
$filename = Str::random(6) . '_' . (string)time() . '_' . $file->getClientOriginalName();
```