Django集成S3存储桶报ValueError: Invalid endpoint如何解决

报错由AWS_S3_ENDPOINT_URL配置错误直接引发，具体问题有两个：

• AWS_S3_ENDPOINT_URL需要填写S3服务的根访问端点，不可拼接存储桶名称。S3 SDK会自动结合配置的桶名、区域参数生成最终的资源访问路径，手动将桶名写入端点值会被SDK判定为非法格式。
• 配置的端点值缺少*https://*协议头，不符合标准URL格式要求。

方案1：移除手动端点配置（官方AWS S3场景首选） #

使用原生AWS S3服务时无需手动指定端点，只要区域参数配置正确，boto3 SDK会自动匹配对应区域的官方S3端点，从根源避免格式错误。
修正后的配置参考：

AWS_ACCESS_KEY_ID = config('STATIC_ACCESS_KEY_ID')
AWS_SECRET_ACCESS_KEY = config('STATIC_SECRET_KEY')
AWS_S3_REGION_NAME = config('AWS_REGION')
AWS_STORAGE_BUCKET_NAME = config('STATIC_BUCKET_NAME')
# 删除原错误的AWS_S3_ENDPOINT_URL配置项
AWS_S3_OBJECT_PARAMETERS = {
    'CacheControl': 'max-age=86400',
}

AWS_LOCATION = 'static'
AWS_DEFAULT_ACL = 'public-read'

STATICFILES_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
# 静态文件地址可直接由django-storages自动生成，如需手动配置按以下格式书写即可
STATIC_URL = f'https://{AWS_STORAGE_BUCKET_NAME}.s3.{AWS_S3_REGION_NAME}.amazonaws.com/{AWS_LOCATION}/'

配置修改完成后重启Django服务即可生效。

方案2：自定义端点场景配置方式 #

如果使用S3兼容存储服务（如MinIO、其他云厂商对象存储）必须手动指定端点，端点值仅填写带协议头的服务根地址即可，禁止拼接桶名：

# 示例：AWS美东1区S3根端点，其他场景替换为对应服务的根地址
AWS_S3_ENDPOINT_URL = 'https://s3.us-east-1.amazonaws.com'

配置后STATIC_URL无需手动拼接端点，django-storages会自动结合桶名、路径参数生成正确的访问地址。

内容的提问来源于stack exchange，提问作者Rohit Hazare