部署Laravel+VueJS至AWS后，S3 PutObject报Bucket参数为空异常

这个错误InvalidArgumentException: The PutObject operation requires non-empty parameters: Bucket很明确——你的Laravel应用在生产环境中无法获取到S3存储桶的名称，导致AWS SDK无法执行上传操作。本地环境正常是因为你的本地.env文件配置正确，但部署到EC2后配置没跟上，或者缓存导致旧配置生效。

下面是一步步的修复方案：

1. 检查并修正.env文件的S3配置 #

登录到你的EC2服务器，找到Laravel项目根目录下的.env文件，确保以下S3相关的环境变量都正确填写：

AWS_ACCESS_KEY_ID=你的AWS访问密钥ID
AWS_SECRET_ACCESS_KEY=你的AWS秘密访问密钥
AWS_DEFAULT_REGION=你的S3存储桶所在区域（比如us-east-1、ap-southeast-1）
AWS_BUCKET=你的S3存储桶的完整名称
AWS_USE_PATH_STYLE_ENDPOINT=false

注意：这些值要和你在AWS控制台创建的S3存储桶、IAM用户的密钥完全匹配，不能有拼写错误或者空格。

2. 确认config/filesystems.php的S3配置 #

打开项目的config/filesystems.php文件，检查s3磁盘的配置是否正确引用了环境变量：

'disks' => [
    // 其他磁盘配置...
    's3' => [
        'driver' => 's3',
        'key' => env('AWS_ACCESS_KEY_ID'),
        'secret' => env('AWS_SECRET_ACCESS_KEY'),
        'region' => env('AWS_DEFAULT_REGION'),
        'bucket' => env('AWS_BUCKET'),
        'url' => env('AWS_URL'),
        'endpoint' => env('AWS_ENDPOINT'),
        'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
    ],
],

重点确认bucket字段是通过env('AWS_BUCKET')获取的，而不是硬编码为空或者错误的值。

3. 清除Laravel的配置缓存 #

部署后Laravel可能会缓存旧的配置，即使你修改了.env也不会立即生效。在服务器的项目根目录下运行以下命令：

php artisan config:clear
php artisan cache:clear

这会清除配置缓存和应用缓存，让新的.env配置生效。

4. 验证AWS IAM用户的权限 #

确保你在.env中填写的AWS密钥对应的IAM用户拥有S3存储桶的上传权限。你可以在AWS控制台的IAM页面给该用户添加以下策略（替换成你的存储桶名称）：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject" // 如果需要读取权限也加上
            ],
            "Resource": "arn:aws:s3:::你的存储桶名称/*"
        }
    ]
}

如果权限不足，也会导致上传失败，不过当前错误是Bucket为空，所以这一步是兜底验证。

完成以上步骤后，再测试图片上传功能，应该就能解决这个问题了。

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