Flask上传S3遇NoCredentialsError：手动传凭证仍无法定位凭证

嘿，作为经常和Flask、S3打交道的开发者，我太懂这种明明传了凭证却报错的糟心了！咱们一步步排查解决：

首先，确认凭证变量真的被正确加载了 #

很多时候问题出在变量没拿到值，比如环境变量没读对、拼写错了变量名（比如把S3_SECRET写成S3_SECRECT），或者变量是空字符串/None。

在初始化boto3客户端前，加个简单的打印验证：

print(f"S3_KEY是否存在: {bool(S3_KEY)}, S3_SECRET是否存在: {bool(S3_SECRET)}")

如果输出是False，那先去搞定变量赋值，比如检查Flask的环境变量加载（用os.getenv的时候有没有写错变量名），或者直接硬编码测试（测试完记得删掉！）。

检查boto3资源的初始化是否带了凭证 #

你代码里同时初始化了boto3.client()和boto3.resource()，但resource没有传入凭证参数！如果后续上传操作是用myclient（也就是resource对象）来做的，它会默认去系统找凭证（比如~/.aws/credentials文件、环境变量），完全忽略你手动传给client的凭证。

修正resource的初始化，把凭证参数加上：

myclient = boto3.resource(
    's3',
    region_name="eu-west-1",
    endpoint_url=S3_LOCATION,
    aws_access_key_id=S3_KEY,
    aws_secret_access_key=S3_SECRET
)

验证endpoint_url的正确性 #

如果是用AWS原生S3，其实可以不用指定endpoint_url，boto3会根据region_name自动匹配正确的端点；如果是用第三方S3兼容存储（比如MinIO），S3_LOCATION必须是完整的URL格式（比如http://localhost:9000），不能少了http://或https://。

用极简脚本隔离问题 #

有时候Flask的请求上下文会干扰变量加载，你可以写个脱离Flask的测试脚本，直接验证boto3能否连接S3：

import boto3

# 替换成你的真实凭证和区域
TEST_KEY = "你的AWS Access Key"
TEST_SECRET = "你的AWS Secret Key"
TEST_REGION = "eu-west-1"

s3_test_client = boto3.client(
    's3',
    region_name=TEST_REGION,
    aws_access_key_id=TEST_KEY,
    aws_secret_access_key=TEST_SECRET
)

# 尝试列出桶，验证连接
try:
    buckets = s3_test_client.list_buckets()
    print("连接成功！你的桶列表：", [b['Name'] for b in buckets['Buckets']])
except Exception as e:
    print(f"连接失败：{str(e)}")

如果这个脚本报错，那就是凭证本身的问题（比如key/secret无效、账号没有S3权限）；如果成功，那问题就出在Flask代码里的变量传递或逻辑上。

最后，给你修正后的完整上传代码参考 #

import boto3
import time
from flask import request

# 确保这些变量已正确赋值
S3_KEY = "你的Access Key"
S3_SECRET = "你的Secret Key"
S3_REGION = "eu-west-1"
S3_BUCKET = "你的存储桶名称"
# AWS原生S3可注释掉下面这行，第三方存储则填正确的endpoint
S3_ENDPOINT = "https://s3.eu-west-1.amazonaws.com"

# 统一初始化client和resource，都带上凭证
s3_client = boto3.client(
    's3',
    region_name=S3_REGION,
    endpoint_url=S3_ENDPOINT,
    aws_access_key_id=S3_KEY,
    aws_secret_access_key=S3_SECRET
)

def handle_file_upload():
    data_files = request.files.getlist('file[]')
    for data_file in data_files:
        if data_file.filename == '':
            continue  # 跳过空文件
        filename = data_file.filename
        # 读取文件内容并上传
        s3_client.put_object(
            Bucket=S3_BUCKET,
            Key=filename,
            Body=data_file.read()
        )
    return "文件上传完成！"

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