Django配置AWS S3托管静态文件路径不匹配、资源加载失败问题排查

出现同名嵌套文件夹、静态资源路径不匹配的根源是django-storages的配置逻辑冲突：你手动拼接的AWS_S3_ENDPOINT_URL已经包含了桶名信息，boto3客户端在执行上传时，会自动按照「Endpoint基础地址 + 存储桶名 + 目标文件相对路径」的规则拼接文件存储Key，等于在桶内强制生成了一层和桶名同名的冗余目录，最终导致实际存储路径和Django生成的访问URL错位。

推荐方案：消除冗余嵌套目录，对齐存储路径 #

直接删除冗余重复的endpoint配置，让django-storages自动按照AWS标准规则生成路径和URL，调整后的配置段如下：

AWS_STORAGE_BUCKET_NAME = "bucket_name"
AWS_ACCESS_KEY_ID = os.environ.get("AWS_ACCESS_KEY_ID")
AWS_SECRET_ACCESS_KEY = os.environ.get("AWS_SECRET_ACCESS_KEY")
AWS_S3_FILE_OVERWRITE = False
AWS_S3_REGION_NAME = "us-east-2"
# 仅保留自定义访问域名配置
AWS_S3_CUSTOM_DOMAIN = f"{AWS_STORAGE_BUCKET_NAME}.s3.{AWS_S3_REGION_NAME}.amazonaws.com"
AWS_LOCATION = "static"
# STATIC_URL直接基于自定义域名拼接静态文件前缀路径
STATIC_URL = f"https://{AWS_S3_CUSTOM_DOMAIN}/{AWS_LOCATION}/"
STATICFILES_STORAGE = "storages.backends.s3boto3.S3Boto3Storage"

核心要删除的就是手动拼接的AWS_S3_ENDPOINT_URL行——这行配置把已经带桶名的自定义域名当成了S3接口根地址，是导致路径错位的直接原因。

配置调整完成后需要执行的操作：

• 清空S3存储桶内之前生成的冗余同名嵌套文件夹，避免残留文件造成路径混乱
• 重新执行python manage.py collectstatic命令上传静态文件
• 验证效果：S3内静态文件将直接存储在static/路径下，不会生成额外的同名嵌套文件夹，Django生成的访问URL与实际文件路径完全匹配

备选方案：适配现有嵌套目录结构，修正URL生成规则 #

如果不想改动S3中已经存储的现有文件结构，只需要调整Django的路径生成规则，补上缺失的嵌套目录层级即可，需要修改两处配置：

1. 调整AWS_LOCATION参数，补上冗余嵌套目录的前缀：

# 原配置 AWS_LOCATION = "static"，修改为
AWS_LOCATION = f"{AWS_STORAGE_BUCKET_NAME}/static"

2. 删除冗余的endpoint配置，基于自定义域名生成匹配实际存储路径的静态资源URL：

# 移除多余的AWS_S3_ENDPOINT_URL定义
AWS_S3_CUSTOM_DOMAIN = f"{AWS_STORAGE_BUCKET_NAME}.s3.{AWS_S3_REGION_NAME}.amazonaws.com"
STATIC_URL = f"https://{AWS_S3_CUSTOM_DOMAIN}/{AWS_LOCATION}/"

调整完成后不需要改动S3内已存储的文件，直接重新执行静态文件收集命令即可让路径规则完全对齐。

对应你之前的调试现象说明：你之前修改AWS_STORAGE_BUCKET_NAME时嵌套文件夹名称会同步变化、调整AWS_LOCATION无法消除这层嵌套目录，本质都是boto3客户端识别到endpoint重复携带桶名信息后，自动将桶名作为额外路径前缀拼接的逻辑导致的，和存储桶策略、存储后端配置无关。

内容的提问来源于stack exchange，提问作者Jonathon K