Django部署Heroku报staticfiles重复错误，如何排查并完成部署？

报错根因 #

你遇到的Application labels aren't unique, duplicates: staticfiles报错和数据库配置完全无关，是Django的INSTALLED_APPS列表中重复注册了staticfiles应用导致的。

从你贴出的配置来看，你已经手动在INSTALLED_APPS里添加了django.contrib.staticfiles，触发重复的常见原因有两个：

• 你的settings.py其他位置（比如分环境的配置块、末尾追加配置的代码）又额外添加了一次django.contrib.staticfiles
• Heroku官方Django构建包会自动为部署项目注入django.contrib.staticfiles，你手动添加的条目和自动注入的条目冲突

疑问解答 #

1. 部署到Heroku是否必须完成迁移操作？ #

是，必须完成。Django的数据库迁移操作是将你的模型定义同步到数据库表结构的必要步骤，如果你不执行迁移，Heroku上绑定的PostgreSQL数据库没有对应业务表，项目运行时会直接抛出表不存在的报错。
你可以在代码推送到Heroku后，手动执行heroku run python manage.py migrate完成迁移，也可以在Procfile中添加release命令自动执行迁移，示例：

release: python manage.py migrate
web: gunicorn 你的项目名.wsgi

2. 该报错是否与数据库配置有关？ #

完全无关，该报错是应用注册阶段触发的，还没到数据库连接、读取配置的步骤，和你的数据库配置没有任何关联。

解决步骤 #

1. 先排查你完整的settings.py文件，确认除了贴出的INSTALLED_APPS段之外，没有其他对INSTALLED_APPS追加django.contrib.staticfiles的代码
2. 如果确认本地配置没有重复，直接删除你手动添加的'django.contrib.staticfiles'条目即可，Heroku构建包会自动注入该应用，不会影响静态文件功能
3. 调整配置后重新推送代码到Heroku，再执行迁移操作即可正常部署

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