Laravel上传至AWS S3 Bucket失败，始终返回false

1. 开启异常抛出，获取具体错误信息 #

当前S3磁盘配置中'throw' => false，会导致上传失败时仅返回false而不抛出异常，无法定位问题。修改配置文件中的throw值为true：

's3' => [
    // ... 其他配置项
    'throw' => true,
],

修改后重新测试，此时try-catch会捕获到具体异常信息（如权限不足、区域不匹配、密钥错误等），这是排查问题的核心第一步。

2. 验证环境变量是否正确加载 #

Laravel可能存在配置缓存，导致.env中的修改未生效。执行以下命令清除缓存：

php artisan config:clear

同时在测试路由中添加变量打印，确认.env信息是否正确读取：

Route::get('/', function () {
    // 打印环境变量验证
    dd([
        'key' => env('AWS_ACCESS_KEY_ID'),
        'region' => env('AWS_DEFAULT_REGION'),
        'bucket' => env('AWS_BUCKET'),
    ]);
    // ... 原上传代码
});

3. 检查IAM权限与桶策略冲突 #

• 确认IAM用户的s3FullAccess权限已正确附加，可通过AWS控制台的IAM用户权限页面查看生效策略。
• 检查桶的桶策略：即使IAM用户有全权限，如果桶策略设置了拒绝上传的规则（比如测试时的最低权限配置），也会导致上传失败。可临时移除桶策略，仅保留IAM用户权限测试。

4. 确认区域与桶名称完全匹配 #

• 确保.env中的AWS_DEFAULT_REGION与S3桶实际所在区域的代码完全一致（例如：新加坡区域需填写ap-southeast-1，而非中文名称）。
• 检查桶名称拼写是否正确，S3桶名称为全局唯一，拼写错误会导致无法找到目标桶。

5. 调整路径样式端点设置（针对特殊场景） #

如果使用官方AWS S3，默认use_path_style_endpoint => false即可，但部分旧区域或特殊环境可能需要开启路径样式：

'use_path_style_endpoint' => true,

修改后重新测试上传。

6. 排查本地网络与PHP依赖 #

• 确认本地开发环境能正常访问AWS S3端点，可通过curl命令测试：

curl https://s3.<你的区域>.amazonaws.com/<你的桶名称>

• 检查PHP是否开启curl扩展：AWS SDK依赖curl进行HTTP请求，可通过php -m命令查看已安装的扩展列表。

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