部署Django应用到Heroku时缺失on_delete参数的问题排查

看起来你遇到的是本地环境正常但Heroku部署时依赖或版本不一致导致的问题，我来帮你一步步排查：

1. 优先检查依赖版本一致性 #

这是最常见的原因——本地和Heroku上安装的Django或django-audit-log版本不匹配。

• 先在本地执行pip freeze > requirements.txt，把当前本地的所有依赖版本锁定下来，确保Heroku安装的和本地完全一致。
• 然后通过heroku run pip freeze查看Heroku上实际安装的依赖，对比本地的输出，重点看Django和django-audit-log的版本是否一致。比如如果本地用Django 3.2，但Heroku上因为requirements没锁版本装了Django 2.0，或者django-audit-log版本过旧没适配Django的on_delete要求，就会出现这个错误。

2. 排查django-audit-log的兼容性 #

旧版本的django-audit-log确实存在未添加on_delete参数的问题，尤其是在Django 2.0+之后，外键必须指定这个参数。

• 如果你的django-audit-log版本比较老，尝试升级到最新的稳定版：在requirements.txt里改成django-audit-log==<最新兼容版本>（比如目前最新的是0.6.0，你可以根据自己的Django版本选择）。
• 如果你是自定义了audit log的模型，直接检查模型里的所有外键字段，确保都添加了on_delete参数，比如：

  models.ForeignKey(User, on_delete=models.CASCADE)
  

3. 验证Heroku环境的collectstatic命令 #

直接在Heroku上手动执行collectstatic，确认错误是否复现：

heroku run python manage.py collectstatic --noinput

如果这里也报错，那说明确实是Heroku环境的问题；如果不报错，可能是部署过程中的缓存或配置问题。

4. 清除Heroku的构建缓存 #

有时候Heroku会缓存之前的依赖包，导致新的requirements没有被正确安装。可以执行以下命令清除缓存后重新部署：

heroku plugins:install heroku-builds
heroku builds:cache:purge
git push heroku master

5. 检查settings配置是否一致 #

确认Heroku使用的settings文件和本地一致：

• 查看Heroku的环境变量：heroku config:get DJANGO_SETTINGS_MODULE，对比本地的DJANGO_SETTINGS_MODULE是否相同。
• 如果生产环境的settings里引入了本地没用到的模型或应用，检查这些部分是否存在外键未加on_delete的问题。

按照这些步骤排查，应该能找到问题所在。我之前遇到过类似情况，就是因为Heroku自动安装了最新版的django-audit-log，而那个版本和我的Django版本不兼容，锁定版本后就解决了。

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