使用boto3从Amazon S3下载文件返回空文件问题求助

故障排查步骤 #

• 先验证S3源对象的实际大小，调用head_object接口确认对象非空，排除源端问题：

import boto3

s3 = boto3.client('s3')
resp = s3.head_object(Bucket='替换为实际桶名', Key='替换为实际对象键')
print(f"源对象大小：{resp['ContentLength']} 字节")

如果返回大小为0，说明源对象本身为空，和下载逻辑无关。

• 确认客户端区域与桶区域一致，区域不匹配时可能出现无报错但响应体为空的异常，初始化客户端时明确指定桶所在的AWS区域：

s3 = boto3.client('s3', region_name='替换为桶实际所属区域，例如us-east-1')

• 若桶开启了版本控制，指定版本号下载，避免拉取到删除标记对应的空版本：

s3.download_file(
    'BUCKET_NAME',
    'OBJECT_NAME',
    'AWS Account Roles.csv',
    ExtraArgs={'VersionId': '替换为目标对象的版本ID'}
)

• 确认本地写入权限，将保存路径替换为绝对路径测试，避免写入无权限目录导致仅生成空文件：

s3.download_file('BUCKET_NAME', 'OBJECT_NAME', '/替换为实际绝对路径/AWS Account Roles.csv')

• 排查网络拦截问题，若当前网络配置了代理、防火墙规则，可能会截断S3的响应体仅返回响应头，导致下载无报错但文件为空，可切换无限制网络重试。

• 若以上步骤未定位问题，可开启boto3调试日志查看完整请求响应详情：

import logging
import boto3

boto3.set_stream_logger('', logging.DEBUG)
s3 = boto3.client('s3')
# 后续执行下载逻辑

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