运行collectstatic后Django静态文件无法上传至AWS S3

根据你描述的情况，collectstatic显示文件未修改但S3桶中无文件，说明Django并未真正将文件上传到S3，以下是针对性的排查和解决步骤：

1. 修正存储桶名称不匹配的问题 #

你的settings.py中AWS_STORAGE_BUCKET_NAME设置为'my-bucket'，但桶策略里的资源路径是arn:aws:s3:::cats-gallery-amanda/static/*，两者存储桶名称不一致。这会导致Django尝试将文件上传到错误的桶（或不存在的桶），直接修改settings.py中的桶名称为实际使用的cats-gallery-amanda：

AWS_STORAGE_BUCKET_NAME = 'cats-gallery-amanda'

2. 添加AWS区域配置 #

默认情况下boto3可能无法正确识别你的存储桶所在区域，导致连接失败。在settings.py中添加桶对应的区域（比如us-east-1、ap-southeast-1等）：

AWS_S3_REGION_NAME = '你的存储桶区域'

3. 确保IAM用户具备足够权限 #

仅设置桶的公共读策略不够，用于上传文件的IAM用户需要具备上传和列出桶内容的权限。给该用户添加以下IAM策略：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:ListBucket",
        "s3:GetObject"
      ],
      "Resource": [
        "arn:aws:s3:::cats-gallery-amanda",
        "arn:aws:s3:::cats-gallery-amanda/*"
      ]
    }
  ]
}

4. 用详细日志排查collectstatic行为 #

运行collectstatic时增加详细日志输出，查看文件处理的具体过程，是否有隐藏的错误：

python manage.py collectstatic --verbosity 2

如果存在权限不足、连接超时等问题，详细日志会给出明确提示。

5. 测试S3连接有效性 #

通过Django Shell测试能否正常连接S3并上传文件，验证配置是否生效：

# 进入Django Shell
python manage.py shell

# 执行测试代码
from storages.backends.s3boto3 import S3Boto3Storage
storage = S3Boto3Storage()

# 上传测试文件
with open('/tmp/test.txt', 'w') as f:
    f.write('test content')
storage.save('static/test.txt', open('/tmp/test.txt', 'rb'))

# 检查文件是否存在
print(storage.exists('static/test.txt'))

如果输出True，说明连接正常；如果报错，根据错误信息（如凭证无效、区域错误）进一步修正配置。

6. 确认STATIC_ROOT配置（可选） #

虽然使用S3存储时STATIC_ROOT不是必须项，但如果你的项目中设置了本地路径，可能会导致Django优先处理本地目录。可以将其设置为一个临时目录，或者直接注释（确保不会和本地静态文件目录冲突）：

STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

完成上述调整后，重新运行collectstatic，应该能看到文件正常上传到S3的static/目录下，同时可通过S3域名访问静态文件。

内容的提问来源于stack exchange，提问作者Amanda Alkmim