PHP：生成唯一文件名及解决上传下载匹配问题

你的问题根源在于两个关键缺失：一是原文件名和实际存储的哈希文件名之间没有建立映射关系，二是md5_file()的用法完全错误——它需要接收文件的路径/内容，而不是原文件名字符串。直接给它传$fileName（比如file.txt），它会把这个字符串当成文件路径去读取，自然找不到文件，生成的哈希和上传时的文件哈希完全不一致，导致下载时找不到存储的文件。

另外原代码也没实现「重复上传同一文件不保存」的需求，因为没有检查文件内容是否已存在就直接存储了。

我们需要通过数据库建立映射关系，同时修正哈希计算逻辑，下面是分步实现：

1. 创建映射存储表（数据库） #

首先建一个数据库表，用来记录原文件名、实际存储的哈希文件名、文件内容哈希，实现重复上传判断和下载时的反向查找。以MySQL为例：

CREATE TABLE files (
    id INT AUTO_INCREMENT PRIMARY KEY,
    original_name VARCHAR(255) NOT NULL,
    stored_name VARCHAR(255) NOT NULL UNIQUE,
    file_hash VARCHAR(64) NOT NULL UNIQUE, -- 用SHA-256比MD5更安全
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

同时在Laravel中创建对应的Model（比如app/Models/File.php），关联这个表。

2. 重写storeFile上传方法 #

修改上传逻辑，加入重复上传判断和映射记录：

public function storeFile(Request $request) {
    $file = $request->file('file');
    // 先校验文件有效性
    if (!$file->isValid()) {
        return response()->json('Invalid file uploaded', 400);
    }

    // 计算文件内容的哈希值（用来判断是否重复上传）
    $fileHash = hash_file('sha256', $file->getRealPath());
    
    // 检查是否已经上传过相同内容的文件
    $existingFile = \App\Models\File::where('file_hash', $fileHash)->first();
    if ($existingFile) {
        // 可选：如果原文件名还没记录过，新增一条映射（避免同一文件多次上传不同原文件名找不到）
        $hasMapping = \App\Models\File::where('original_name', $file->getClientOriginalName())
            ->where('file_hash', $fileHash)
            ->exists();
        if (!$hasMapping) {
            \App\Models\File::create([
                'original_name' => $file->getClientOriginalName(),
                'stored_name' => $existingFile->stored_name,
                'file_hash' => $fileHash
            ]);
        }
        return response()->json([
            'message' => 'File already exists in storage',
            'original_name' => $file->getClientOriginalName()
        ], 200);
    }

    // 生成唯一存储文件名（直接用文件哈希+后缀，保证唯一性）
    $storedFileName = $fileHash . '.' . $file->getClientOriginalExtension();
    $storageDir = storage_path('app/file');
    // 移动文件到存储目录
    $file->move($storageDir, $storedFileName);

    // 记录映射到数据库
    \App\Models\File::create([
        'original_name' => $file->getClientOriginalName(),
        'stored_name' => $storedFileName,
        'file_hash' => $fileHash
    ]);

    return response()->json([
        'original_name' => $file->getClientOriginalName(),
        'extension' => $file->getClientOriginalExtension(),
        'stored_name' => $storedFileName,
        'storage_path' => $storageDir . '/' . $storedFileName
    ], 201);
}

3. 重写downloadFile下载方法 #

现在可以通过原文件名从数据库找到对应的存储文件：

public function downloadFile($fileName) {
    // 根据原文件名查找对应的存储记录
    $fileRecord = \App\Models\File::where('original_name', $fileName)->first();
    if (!$fileRecord) {
        return response()->json('File not found', 404);
    }

    $fullPath = storage_path('app/file/' . $fileRecord->stored_name);
    // 额外校验存储文件是否存在（避免数据库有记录但文件被误删）
    if (!file_exists($fullPath)) {
        return response()->json('File missing from storage', 404);
    }

    // 下载时返回原文件名给用户
    return response()->download($fullPath, $fileName);
}

• 哈希计算修正：用hash_file('sha256', $file->getRealPath())替代原代码的md5_file($file)，getRealPath()能获取上传文件的临时路径，这样计算的哈希是文件内容的真实哈希，用来判断重复上传更准确。
• 映射关系：数据库表解决了原文件名和存储文件名的对应问题，这是实现「下载时通过原文件名查找文件」的核心。
• 重复上传处理：先检查文件哈希是否存在，存在则跳过存储，完全符合「重复上传同一文件不保存」的需求。
• 错误处理：增加了文件有效性、存储文件存在性的校验，返回的错误信息更清晰。

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