上传文章时数据库写入失败，已上传文件无法自动删除的问题排查

Hey there! 这种“文件传上去了但数据库挂了，没法删文件”的问题我碰到过好多次，基本都和异常处理不到位、路径出错或者权限问题有关，给你拆解几个最可能的原因和对应的解决办法：

1. 异常捕获范围没覆盖数据库操作 #

很多开发者会把文件上传和数据库操作放一块，但只捕获了文件上传的异常，完全没管数据库操作抛出的错误。举个例子，你的代码可能是这样的：

// 错误示例伪代码
try {
    // 上传文件
    $uploadedPath = saveUploadedFile();
    // 创建数据库条目
    Article::create($data);
} catch (UploadFailedException $e) {
    // 只处理上传异常，数据库炸了根本抓不到
    logger()->error('上传失败：'.$e->getMessage());
}

这种情况下，数据库操作抛出的异常会直接中断程序，删除文件的代码根本没机会执行。

怎么修：
把所有可能出错的步骤都放进try块，然后在catch里统一处理文件删除：

$uploadedPath = null;
try {
    $uploadedPath = saveUploadedFile();
    Article::create($data);
} catch (Exception $e) {
    // 只要出异常，且文件已经上传成功，就删它
    if ($uploadedPath && file_exists($uploadedPath)) {
        unlink($uploadedPath);
        logger()->info('已清理未入库的文件：'.$uploadedPath);
    }
    logger()->error('上传流程失败：'.$e->getMessage());
    throw $e; // 可选，根据业务需求要不要把异常抛出去
}

2. 文件路径不对，删了个寂寞 #

你可能在删除时用的路径和上传时保存的路径不一致——比如上传时用的是绝对路径，删除时用了相对路径，或者路径里有拼写错误，导致程序找不到文件，看起来像是“没执行删除逻辑”，实际上是删了个不存在的文件。

排查点：

• 把$uploadedPath的值打日志，确认删除时这个路径是正确的，且文件真的存在。
• 一定要用file_exists($uploadedPath)先判断文件存在，再执行删除，避免做无用功。

3. 数据库自定义异常没被捕获 #

有些框架（比如Laravel、Spring）会抛出自定义的数据库异常，比如QueryException，如果你只捕获了通用的Exception以外的类型，或者捕获范围太窄，就会漏抓这些异常，导致删除逻辑没触发。

怎么修：
确保捕获的异常类型包含数据库操作可能抛出的所有异常——比如在Laravel里，你可以专门捕获Illuminate\Database\QueryException，或者直接捕获最上层的Exception（排查阶段可以用，生产环境建议更精准的捕获）。

4. 服务器权限不够，删不了文件 #

Web进程（比如Nginx的www-data用户）没有该文件或所在目录的写权限，导致删除命令执行失败，但程序没返回错误提示，让你误以为没执行删除逻辑。

排查点：

• 查看文件的权限和所属用户组，确保Web进程有删除权限。
• 在删除代码后加日志，记录删除结果：

if (unlink($uploadedPath)) {
    logger()->info('文件删除成功：'.$uploadedPath);
} else {
    logger()->error('文件删除失败，权限不足或路径错误：'.$uploadedPath);
}

5. 代码顺序完全错了 #

比如你把删除逻辑写在了数据库操作成功的分支里，或者写在了异常捕获范围之外，导致永远不会执行。比如：

// 错误示例
$uploadedPath = saveUploadedFile();
Article::create($data);
// 只有数据库成功才会到这，失败的话根本走不到
if (数据库操作失败) {
    unlink($uploadedPath);
}

这种顺序完全错误，必须把删除逻辑放在异常处理分支里，或者数据库操作失败的回调里。

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