在Django应用中使用DigitalOcean Spaces初始化boto3会话报错

问题核心 #

boto3默认会按凭据优先级链加载认证信息，即便你已显式传入DigitalOcean Spaces的密钥，它仍会尝试读取本地~/.aws/credentials和~/.aws/config文件，从而触发ConfigParseError。

解决方案 #

1. 彻底阻止boto3读取本地凭据文件 #

在settings.py最开头添加以下代码，覆盖AWS凭据文件路径为无效文件，从根源上避免boto3加载本地配置：

import os
# 让boto3找不到本地凭据文件
os.environ['AWS_SHARED_CREDENTIALS_FILE'] = '/dev/null'
os.environ['AWS_CONFIG_FILE'] = '/dev/null'

2. 显式初始化boto3会话与客户端 #

替换你当前的boto3客户端初始化代码，直接在会话创建时传入凭据，完全脱离默认加载链：

# 替换原有的session和s3_client初始化逻辑
session = boto3.session.Session(
    aws_access_key_id=AWS_ACCESS_KEY_ID,
    aws_secret_access_key=AWS_SECRET_ACCESS_KEY,
    region_name=AWS_S3_REGION_NAME
)

s3_client = session.client(
    's3',
    endpoint_url=AWS_S3_ENDPOINT_URL,
    config=Config(signature_version='s3v4')
)

3. 确保Django存储后端使用显式凭据 #

检查custom_storages.py文件，修改存储类使其使用显式传入的凭据初始化客户端，避免依赖boto3默认行为：

from storages.backends.s3boto3 import S3Boto3Storage
from django.conf import settings
import boto3
from botocore.client import Config

class StaticStorage(S3Boto3Storage):
    location = 'static'
    default_acl = 'public-read'

    def __init__(self, *args, **kwargs):
        # 显式创建客户端并传入Spaces凭据
        client = boto3.client(
            's3',
            region_name=settings.AWS_S3_REGION_NAME,
            endpoint_url=settings.AWS_S3_ENDPOINT_URL,
            aws_access_key_id=settings.AWS_ACCESS_KEY_ID,
            aws_secret_access_key=settings.AWS_SECRET_ACCESS_KEY,
            config=Config(signature_version='s3v4')
        )
        kwargs['client'] = client
        super().__init__(*args, **kwargs)

class MediaStorage(S3Boto3Storage):
    location = 'media'
    file_overwrite = False

    def __init__(self, *args, **kwargs):
        client = boto3.client(
            's3',
            region_name=settings.AWS_S3_REGION_NAME,
            endpoint_url=settings.AWS_S3_ENDPOINT_URL,
            aws_access_key_id=settings.AWS_ACCESS_KEY_ID,
            aws_secret_access_key=settings.AWS_SECRET_ACCESS_KEY,
            config=Config(signature_version='s3v4')
        )
        kwargs['client'] = client
        super().__init__(*args, **kwargs)

4. 清理冗余测试代码 #

移除settings.py中的test_s3_connection函数及调用，该代码会在Django初始化阶段提前触发boto3凭据加载，可能引发不必要的错误。

验证步骤 #

1. 重启Django服务器：python3 manage.py runserver
2. 尝试收集静态文件或上传媒体文件：python3 manage.py collectstatic
3. 检查控制台输出，确认不再出现ConfigParseError

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