Laravel测试报错：使用Storage::fake()无法找到文件路径

你遇到的问题核心原因很明确：控制器中存储文件时生成的文件名和测试里断言的文件名完全不一致，导致assertExists('image1.jpg')找不到文件。

具体原因拆解 #

看你的控制器代码，存储文件时生成的文件名是：

$fileName = md5($image . microtime()) . '.' . $image->getClientOriginalExtension();

这个文件名是基于文件内容+当前微时间的MD5值，再加上原扩展名，最终会生成类似a1b2c3d4e5f6...jpg这样的动态字符串，和测试里的原始文件名image1.jpg完全不同。你在测试里断言原始文件名存在，自然会失败。

解决方案 #

根据你的需求，有两种常见的解决思路：

思路1：让控制器返回存储的文件名，测试中基于返回值断言

修改控制器的store方法，把存储的文件名收集起来并返回：

public function store(Request $request)
{
    $storedFiles = [];
    if ($request->hasFile('filename')) {
        foreach ($request->file('filename') as $image) {
            $fileName = md5($image . microtime()) . '.' . $image->getClientOriginalExtension();
            $image->storeAs('', $fileName, 'uploads');
            $storedFiles[] = $fileName; // 收集存储的文件名
        }
    }
    return response()->json(['stored_files' => $storedFiles]); // 返回给测试用
}

然后修改测试代码，捕获响应中的文件名，再进行断言：

public function testUserCanSuccessfullySubmitSingleImage(): void
{
    Storage::fake('uploads');
    
    $response = $this->postJson('/upload', [
        'filename' => UploadedFile::fake()->image('image1.jpg')
    ]);
    
    // 获取返回的存储文件名
    $storedFileName = $response->json('stored_files')[0];
    
    Storage::disk('uploads')->assertExists($storedFileName);
    Storage::disk('uploads')->assertMissing('missing.jpg');
}

思路2：统一文件名生成逻辑，测试中复用

如果不想修改控制器返回值，可以把文件名生成的逻辑抽成一个单独的方法（比如放在模型或者工具类里），这样控制器和测试都可以复用这个逻辑，避免不一致：

比如创建一个工具方法：

// 可以放在app/Helpers/FileHelper.php或者其他合适的位置
function generateStoredFileName($image)
{
    return md5($image . microtime()) . '.' . $image->getClientOriginalExtension();
}

控制器中调用这个方法：

$fileName = generateStoredFileName($image);

测试中也调用同一个方法来生成预期的文件名：

public function testUserCanSuccessfullySubmitSingleImage(): void
{
    Storage::fake('uploads');
    
    $fakeImage = UploadedFile::fake()->image('image1.jpg');
    $expectedFileName = generateStoredFileName($fakeImage);
    
    $this->postJson('/upload', [
        'filename' => $fakeImage
    ]);
    
    Storage::disk('uploads')->assertExists($expectedFileName);
    Storage::disk('uploads')->assertMissing('missing.jpg');
}

额外提示 #

如果只是为了测试文件上传的功能，不需要纠结具体的文件名，也可以改用assertCount()来断言存储的文件数量是否正确，比如：

Storage::disk('uploads')->assertCount(1); // 断言上传了1个文件

这样即使文件名是动态生成的，也能验证上传功能是否正常工作。

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