Laravel 8.38 验证超限时上传MP4抛出Psr17Factory打开文件异常
异常产生原因
- 该报错和Laravel内置的文件验证逻辑没有直接关联,根源是上传的MP4文件大小已经超出了PHP配置的全局上传阈值,导致PHP没有生成有效的上传临时文件。
- 当上传文件体积超过PHP的
upload_max_filesize或post_max_size限制时,PHP会直接清空$_FILES全局变量,不会保留任何有效的临时文件路径信息。此时项目中依赖的nyholm/psr7组件在为请求创建标准PSR-7文件流时,无法解析到有效的上传临时文件路径,错误地将Web服务根目录(也就是public目录)识别为需要打开的目标文件。由于public是目录而非可读取的文件,就会直接抛出cannot be opened的运行时异常,根本走不到Laravel内置的大小验证流程。 - 为什么上传超5KB的PNG不会触发异常?因为测试用的超大小PNG文件体积远未达到PHP的全局上传限制,PHP会正常将文件存储到系统临时目录,请求可以完整走完Laravel的验证流程,正常返回大小超标的提示;而测试用的超5KB的MP4,实际体积大概率已经超过了PHP默认的2M上传阈值,直接触发了PHP的上传中断逻辑,才会跳出这个组件级的运行时错误。
修复方案
- 先对齐PHP环境的上传阈值,适配测试场景的文件大小:
找到当前运行环境对应的php.ini配置,调整以下两个参数后重启PHP服务:- 将
upload_max_filesize调整为大于测试用MP4文件的实际体积,比如测试用MP4为3M,就设置为5M - 将
post_max_size设置为大于等于upload_max_filesize,比如设置为6M
调整完成后PHP可以正常接住测试范围内的所有上传文件,不会因为全局限制提前中断上传流程。
- 将
- 增加前置合法性拦截,避免无效上传触发组件异常:
在执行Laravel内置验证规则之前,先判断上传文件的有效性。当上传文件存在异常(比如超过PHP大小限制、上传中断)时,Laravel的UploadedFile对象的isValid()方法会返回false,此时直接拦截返回提示,就不会走到后续的PSR-7流创建逻辑。示例代码参考:// 控制器方法入口 $uploadedFile = $request->file('file'); // 前置拦截无效上传 if (! $uploadedFile || ! $uploadedFile->isValid()) { return back()->withErrors(['file' => '上传文件超过服务器允许的最大体积限制,请调整后重试']); } // 执行原有验证规则 $validated = $request->validate([ 'file' => "max:5|mimes:jpg,png,jpeg,pdf,txt,doc,docx,mp4" ]); - 优化现有验证规则的准确性:
原规则中的mimes是通过文件扩展名做类型判断,遇到MP4这类格式容易出现MIME识别偏差,建议替换为mimetypes规则,通过真实的文件头信息判断类型,减少不必要的校验偏差。优化后的规则参考:'file' => "max:5|mimetypes:image/jpeg,image/png,application/pdf,text/plain,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document,video/mp4" - 如果项目使用Laravel Octane作为服务运行,需要额外检查Octane的临时文件配置,确保协程场景下临时文件路径不会被错误解析为public目录,避免同类路径识别错误。
内容的提问来源于stack exchange,提问作者saad
相关产品推荐
相关产品推荐

