Django升级后collectstatic无法同步新增静态/媒体文件至AWS S3，django-storages仅选择性创建文件夹

遇到这种选择性同步的问题确实挺闹心的，结合你升级Django到5.2的背景和给出的配置，我整理几个实际项目中常见的排查方向，你可以逐一验证：

1. 检查新应用是否被纳入静态文件收集范围 #

Django的collectstatic只会收集两类静态文件：

• INSTALLED_APPS中注册的应用下的static目录内的文件
• STATICFILES_DIRS配置中指定的额外静态文件目录

你提到升级后新增了一个应用，先确认生产环境的settings.py里，这个新应用是否已经添加到INSTALLED_APPS列表中？很多时候开发环境配置了，但部署生产时漏加是常见的坑。

如果静态文件放在非应用目录下，也要检查STATICFILES_DIRS是否包含了对应的路径，确保Django能找到这些文件。

2. 验证静态文件查找器配置 #

Django默认依赖STATICFILES_FINDERS来定位静态文件，默认配置是：

STATICFILES_FINDERS = [
    'django.contrib.staticfiles.finders.FileSystemFinder',
    'django.contrib.staticfiles.finders.AppDirectoriesFinder',
]

如果升级过程中你修改过这个配置（比如引入了第三方工具），可能导致新的静态文件无法被发现。可以暂时恢复默认配置，再尝试collectstatic测试。

3. 确认django-storages版本与Django 5.2兼容 #

Django 5.x对第三方库的兼容性要求更高，你需要确保django-storages的版本是支持Django 5.2的稳定版。可以在生产环境运行以下命令查看版本：

pip show django-storages

如果版本低于1.14.0，建议升级到最新稳定版：

pip install --upgrade django-storages[boto3]

旧版本的storages可能和Django 5.x的STORAGES配置逻辑不兼容，导致部分文件上传失败。

4. 排查AWS S3的权限与配置细节 #

虽然旧文件能正常访问，但新文件无法上传，可能是权限或存储桶配置的问题：

• 检查AWS_ACCESS_KEY_ID对应的IAM用户权限，确保拥有s3:PutObject、s3:ListBucket权限，且权限覆盖到存储桶的static/和media/路径
• 确认AWS_S3_REGION_NAME是否与你的S3存储桶实际区域一致，区域不匹配可能导致隐性上传失败
• 查看S3存储桶的日志（如果开启了），看有没有文件上传时的权限拒绝或其他错误记录

5. 用调试命令定位问题 #

可以通过以下命令进一步定位问题：

• 运行python manage.py findstatic --all <静态文件名>，测试Django是否能找到新增的静态文件。如果找不到，说明是收集范围的问题；如果能找到，那问题出在storages或S3端
• 运行python manage.py collectstatic --dry-run -v3，查看详细的收集日志，有没有显示新增文件的处理记录，或者是否有隐藏的报错信息

另外要注意：collectstatic仅负责静态文件的同步，媒体文件（MEDIA_ROOT下的内容）不会被这个命令处理。如果是新增的媒体文件无法上传，需要检查用户上传逻辑或手动同步初始化的媒体文件到S3。

内容来源于stack exchange