Laravel上传文件至AWS S3生产环境报错：fopen()文件名不能为空

嘿，我来帮你捋捋这个问题——本地正常、生产环境上传AWS S3失败还报fopen(): Filename cannot be empty，这种环境差异导致的问题其实挺常见的，咱们从几个核心方向排查：

1. 先查生产服务器的文件权限 #

生产环境的临时上传目录大概率是权限出了问题，导致上传的文件没被正确保存到本地临时路径，后续调用S3上传时自然拿不到有效文件路径：

• 先给Laravel的核心目录补权限：

  chmod -R 755 storage bootstrap/cache
  chown -R www-data:www-data storage bootstrap/cache # 如果你用的是Nginx/Apache的www-data用户组
  

• 再检查PHP的临时上传目录：执行php -i | grep upload_tmp_dir，确认这个目录存在且有写入权限，要是路径不对或者没权限，得在php.ini里改完重启服务。

2. 确认请求里的文件是否真的被接收到了 #

有时候生产环境的请求处理和本地有差异，别光直接拿文件上传，先做个有效性校验：

if (!$request->hasFile('video') || !$request->file('video')->isValid()) {
    Log::error('生产环境未接收到有效上传文件');
    return back()->withErrors('文件上传失败，请重试');
}

一定要用$request->file('字段名')获取文件对象，别用$request->input()，后者只能拿到文件名，拿不到真实的临时文件路径。

3. 核对AWS S3的生产环境配置 #

本地.env和生产环境的配置可能没同步，或者IAM权限不够：

• 检查生产环境.env里的AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_DEFAULT_REGION、AWS_BUCKET有没有拼写错误，特别是密钥和桶名。
• 测试下AWS CLI能不能在生产服务器上传文件：

  aws s3 cp /随便找个测试文件.mp4 s3://你的桶名/test/
  

如果CLI能传，说明AWS的凭证和权限没问题，问题出在Laravel的代码或文件处理上。

4. 检查put/putFileAs的调用方式 #

你用put的时候是不是传了空的文件路径？比如错误写法：

// 错误：第二个参数是空内容或者无效路径
Storage::disk('s3')->put('videos/test.mp4', '');

正确的写法应该用文件对象的真实路径，或者直接用Laravel封装好的方法：

$file = $request->file('video');
// 方法1：用putFileAs自动处理
Storage::disk('s3')->putFileAs('videos', $file, $file->getClientOriginalName());
// 方法2：用put传文件流
Storage::disk('s3')->put('videos/' . $file->getClientOriginalName(), fopen($file->getRealPath(), 'r+'));

注意：put的第二个参数可以是文件内容、文件流或者SplFileObject，要是传字符串路径，必须确保这个路径真实存在。

5. 排查PHP的上传大小限制 #

生产环境的php.ini可能限制了上传文件的大小，导致视频这类大文件上传失败，临时文件根本没生成：

• 执行php -i | grep -E "upload_max_filesize|post_max_size"，确认这两个值比你要上传的视频大（比如视频是100M，就设成128M），改完记得重启Web服务器。

最后加个日志排查 #

在生产环境上传前加个详细日志，明确问题出在哪：

$file = $request->file('video');
Log::info('生产环境上传文件详情：', [
    '原始文件名' => $file->getClientOriginalName(),
    '真实路径' => $file->getRealPath(),
    '文件是否存在' => file_exists($file->getRealPath()),
]);

看日志里的真实路径和文件是否存在，就能立刻知道是文件没保存，还是路径传递错了。

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