AWS SDK for PHP调用GetObject返回空Stream问题排查

• AWS SDK for PHP 的getObject接口返回结果中，Body字段并非对象内容的字符串格式，而是GuzzleHttp实现的PSR-7标准Stream流对象。SDK设计上不会在接口返回时自动把全部对象内容加载到内存，避免大文件读取占满内存，因此直接打印流对象本身，只能看到流的元信息（比如你看到的php://temp临时流载体、size: null属性），看不到实际存储的内容。
• 你调用toArray()方法拿到的Body仍然是流对象实例，没有执行任何流读取操作，自然无法获取到对象的有效内容。php://temp是SDK默认使用的临时流包装，当内容大小超过PHP配置的内存阈值时会自动写入磁盘临时文件，属于正常设计，不是返回异常。

根据使用场景选择对应读取方式即可：

1. 小文件场景：直接将流对象强转为字符串读取全部内容
   PSR-7的Stream对象实现了__toString()魔术方法，强转时会自动重置指针并读取全部流内容，使用最简单：

$client = $adapter->getClient();
$objectInfo = $client->getObject(
    [
        'Bucket' => 'bucket-name',
        'Key'    => "key-name",
    ]
);
// 强转流为字符串获取实际内容
$objectContent = (string)$objectInfo['Body'];
dd($objectContent);

2. 大文件/自定义读取场景：调用流方法按需读取
   如果文件体积较大，不想一次性加载全部内容到内存，可以调用流对象内置方法操作，注意读取前先确认指针位置，若之前有过流操作需要先将指针重置到开头：

$stream = $objectInfo['Body'];
// 流支持随机访问的话，重置指针到起始位置
if ($stream->isSeekable()) {
    $stream->rewind();
}
// 读取从当前指针位置到末尾的全部内容
$objectContent = $stream->getContents();
// 也可以指定长度分段读取，适合大文件流式处理
// $chunk = $stream->read(1024); // 每次读取1KB
dd($objectContent);

如果按上述方式读取后仍然为空，再逐一排查以下问题：

• 确认传入的Bucket和Key参数完全正确，对应存储桶内确实存在该对象，且对象本身不是0字节的空文件
• 确认当前使用的AWS凭证拥有目标对象的s3:GetObject权限，权限不足时SDK会抛出对应异常，不会正常返回流对象
• 不要通过dd()直接打印流对象判断内容是否存在，流对象的内部缓存内容不会在打印属性时展示。

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