从8.0升级至10.0后图片无法上传至存储且无报错

核心问题分析 #

你的代码存在几个和Laravel版本升级不兼容的逻辑问题，导致图片看似“上传成功”但实际未正确存储：

1. 目录创建路径错误
   你用public_path($path)判断目录是否存在并创建，但Storage::disk('public')对应的存储根目录是storage/app/public（而非项目根目录下的public），这就导致创建的目录和实际存储路径完全不匹配。当$path为null时，public_path(null)指向项目的public目录（该目录必然存在），所以不会创建默认的temp/image目录，但Storage尝试写入storage/app/public/temp/image时，若该目录不存在，Laravel 10.x的Filesystem行为可能与8.x不同，导致静默失败且无异常抛出。

2. 异常捕获范围不足
   Laravel的Filesystem操作抛出的是Illuminate\Filesystem\FilesystemException等特定异常，而非通用的Exception，所以你的catch (Exception $e)可能未捕获到实际发生的错误，导致你误以为没有异常抛出。

3. 路径变量逻辑不一致
   你定义了$save_path = $path ?? 'temp/image';，但判断目录时用的是$path而非$save_path，当$path为null时，判断的是public目录而非实际要存储的temp/image路径。

修正后的代码 #

public function saveImage($image, ?string $path): string
{
    $savePath = $path ?? 'temp/image';
    $storageDisk = Storage::disk('public');

    try {
        // 用Storage的方法判断目录是否存在，不存在则创建
        if (!$storageDisk->exists(dirname($savePath))) {
            $storageDisk->makeDirectory(dirname($savePath), 0777, true);
        }
        
        // 执行存储，获取完整路径
        $storedPath = $storageDisk->putFile($savePath, $image);
        
        if (!$storedPath) {
            throw new \Illuminate\Filesystem\FilesystemException('图片存储失败');
        }

        return $this->returnBasePath($storedPath);
    } catch (\Illuminate\Filesystem\FilesystemException $e) {
        throw new \Exception('图片存储错误: ' . $e->getMessage(), 500);
    } catch (\Exception $e) {
        throw new \Exception('图片存储异常: ' . $e->getMessage(), 500);
    }
}

关键修改说明 #

• 统一存储路径处理：改用Storage::disk('public')的exists和makeDirectory方法管理存储目录，确保操作的是正确的storage/app/public下的路径。
• 使用putFile方法：putFile是Laravel推荐的文件存储方法，会自动处理文件名生成、目录创建，比直接put更可靠，返回完整的存储路径。
• 扩大异常捕获范围：先捕获Filesystem相关的特定异常，再捕获通用异常，确保能捕获到所有可能的错误。
• 增加存储结果校验：判断putFile的返回值，若为false则主动抛出异常，避免静默失败。

额外排查点 #

1. 符号链接是否正常：重新执行php artisan storage:link，确保public/storage到storage/app/public的符号链接存在。
2. 目录权限：检查storage/app/public及其子目录的权限，确保Web服务器进程（如www-data）有读写权限。
3. 文件大小限制：确认php.ini中的upload_max_filesize和post_max_size设置足够大，避免大文件上传被静默拦截。

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