Symfony实体保存触发文件不存在错误，求排查方案

核心原因分析 #

报错提示临时文件不存在，结合你描述的「注释上传脚本就能正常保存」「flush前对象状态正常」，大概率是代码中残留了对临时上传文件路径的引用，而PHP会在请求过程中（或结束后）自动清理临时上传文件，当Doctrine执行flush时，相关逻辑仍试图访问已被移除/清理的临时文件路径。

具体排查与修复步骤 #

1. 检查实体映射与字段赋值 #

• 确保实体中仅存储最终的文件存储路径（比如/uploads/documents/xxx.pdf），绝对不能把PHP上传的临时文件路径（如/tmp/phpHh98PX）赋值给Doctrine持久化的字段。
• 错误示例：

  // 错误：把临时路径存到实体字段，flush时Doctrine可能尝试访问该路径
  $document->setFile($_FILES['file']['tmp_name']);
  

• 正确示例：

  $tmpFile = $_FILES['file']['tmp_name'];
  $newFilePath = '/uploads/documents/' . uniqid() . '.' . pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION);
  // 先移动文件到指定路径，再把新路径赋值给实体
  if (!move_uploaded_file($tmpFile, $newFilePath)) {
      throw new \RuntimeException('文件移动失败');
  }
  $document->setFile($newFilePath);
  

2. 排查Doctrine生命周期回调 #

如果实体使用了@PrePersist/@PreUpdate注解的方法，检查这些方法里是否有访问临时文件的逻辑：

• 比如在回调中读取文件内容、生成文件哈希，但此时临时文件已经被你手动移动，就会触发「文件不存在」错误。
• 修复：把文件相关的处理逻辑（如生成哈希、读取元数据）移到move_uploaded_file之后执行，确保操作的是已移动后的目标文件。

3. 检查Api Platform的自动处理逻辑 #

由于你使用Api Platform，需确认：

• 实体的文件字段没有配置Api Platform的自动上传注解（比如@ApiProperty(iri="http://schema.org/fileUrl")），这类注解会让框架自动接管临时文件处理，和你手动移动文件的逻辑冲突。
• 如果使用DTO接收上传数据，确保DTO到实体的转换过程中，已经替换成最终的文件路径，而非保留临时路径。

4. 验证临时文件生命周期 #

PHP上传的临时文件会在请求结束后自动删除，但如果你的代码在flush前已经移动了文件，临时文件会被move_uploaded_file移除，此时任何后续访问原临时路径的代码都会报错。可以在flush前打印所有涉及文件路径的变量，确认没有残留临时路径引用。

5. 调试辅助手段 #

• 开启Doctrine SQL日志，查看flush时执行的SQL语句，确认是否有字段携带了临时文件路径。
• 查看PHP错误日志，获取更详细的错误调用栈，定位到具体是哪一行代码触发了文件不存在的错误。

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