You need to enable JavaScript to run this app. Laravel S3调用move方法转移文件时提示File not found at path错误
优惠活动
大模型
产品
解决方案
定价
更多

Laravel S3调用move方法转移文件时提示File not found at path错误

问题原因

你调用Storage::disk('s3')->move()时传入的第一个参数是S3文件的完整公开访问URL,而Laravel文件系统(底层基于Flysystem)的所有文件操作方法,要求传入的路径参数是相对于S3存储桶根目录的相对路径,而非完整HTTP URL。

Flysystem收到完整URL后,会将整个URL当做桶内的文件路径去检索,自然找不到对应文件,因此抛出FileNotFoundException异常。浏览器可以正常访问是因为该URL本身是合法的公开访问地址,和S3 API调用要求的参数格式属于两套不同的规则,不存在冲突。

修复方法

删除第一个参数里的域名前缀,只保留桶内的文件相对路径即可,示例代码如下:

// 仅保留桶内路径 old-path/image.png 即可
Storage::disk('s3')->move("old-path/image.png","/new-folder/123/image.png");

如果你的业务场景只能拿到完整的文件URL,可以通过字符串截取的方式提取相对路径,Laravel也提供了便捷的辅助方法实现该逻辑:

$fullUrl = "https://my-s3-url.s3.aws.com/old-path/image.png";
// 从完整URL中截取桶内相对路径
$relativePath = Str::after($fullUrl, Storage::disk('s3')->url('/'));

Storage::disk('s3')->move($relativePath, "/new-folder/123/image.png");

内容的提问来源于stack exchange,提问作者PinoyStackOverflower

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.19 00:45:04