使用boto3向AWS S3上传文件时文件存在却报FileNotFoundError
报错的根本原因
你遇到的FileNotFoundError和AWS CLI配置、S3权限完全无关,核心问题出在boto3 upload_file()方法的入参逻辑上:upload_file()的第一个参数要求传入Python可在本地文件系统直接定位的完整有效路径,但你当前传入的只是os.listdir()返回的纯文件名片段。
很多YouTube基础教程的示例代码能直接运行,是因为教程作者默认把待上传文件和脚本放在同一个启动工作目录下,直接传文件名刚好能被Python定位到。但你当前的代码里,os.listdir(path)只会返回指定目录下的条目名称(比如age.csv、test.txt),不会自动拼接上目录的前缀路径。当你直接把file变量传给upload_file()时,Python不会去你定义的C:/Users/User/Desktop/.../example_data目录下找文件,而是默认去脚本启动时的当前工作目录下搜索对应名称的文件,自然就会报“系统找不到指定文件”的错误。
你之前做的排查也刚好印证了这个问题:单独打印文件名、判断文件类型的逻辑都不涉及本地文件的读取定位,所以能正常运行;一旦走到需要真实读取本地文件的上传步骤,因为路径不对,就直接报错了。
对应的修复方法
只需要在拿到遍历的文件名后,用os.path.join()把预先定义的目标目录路径和文件名拼接成完整的本地文件路径,再传给upload_file()即可,参考修正后的代码:
import os import boto3 client = boto3.client('s3', aws_access_key_id=access_key, aws_secret_access_key=secret_access_key) target_local_dir = 'C:/Users/User/Desktop/python/projects/AWS-Data-Processing/example_data' target_s3_bucket = 'my-uploaded-data' for file in os.listdir(target_local_dir): # 拼接得到本地文件的完整绝对路径 full_local_path = os.path.join(target_local_dir, file) # 跳过目录类型条目,避免上传逻辑触发非预期错误 if not os.path.isfile(full_local_path): continue print(file) if '.txt' in file: upload_key = 'txt/' + str(file) client.upload_file(full_local_path, target_s3_bucket, upload_key) print("txt") elif '.csv' in file: upload_key = 'csv/' + str(file) client.upload_file(full_local_path, target_s3_bucket, upload_key) print("csv")
容易混淆的补充说明
- 不需要额外安装AWS CLI才能运行这段代码:boto3是独立的Python SDK,不依赖本地AWS CLI的配置,你之前安装AWS CLI没解决问题是正常的,因为问题根因和CLI完全无关
- 拼接绝对路径是最稳妥的文件定位方式:不要依赖脚本的“当前工作目录”找文件,因为你在不同路径下启动Python解释器时,当前工作目录会变化,很容易出现路径错位的问题
- 如果还是排查不通,可以在
upload_file调用前加一行print(os.path.exists(full_local_path)),确认拼接出来的路径是真的能被系统识别到,快速定位路径拼接的问题
内容的提问来源于stack exchange,提问作者Sarah
相关产品推荐
相关产品推荐

