安装Django Debug Toolbar后出现错误，此前项目运行一切正常

1. 基础配置项核查 #

• 确认debug_toolbar已加入INSTALLED_APPS：
  打开项目的settings.py，检查INSTALLED_APPS列表里是否包含'debug_toolbar'，没有的话直接添加进去。
• 检查中间件配置：
  确保MIDDLEWARE中存在'debug_toolbar.middleware.DebugToolbarMiddleware'，注意这个中间件的顺序要放在最前面（至少要在压缩、缓存这类会修改响应内容的中间件之前）。
• 配置内部访问IP：
  在settings.py里添加或修改INTERNAL_IPS，本地开发直接设为：

  INTERNAL_IPS = [ '127.0.0.1', ]
  

  要是在局域网内调试，把你的设备IP也加进去。

2. URL路由配置检查 #

• 项目根urls.py必须添加Debug Toolbar的路由规则：
  插入以下代码，注意要放在其他路由前面，避免冲突：

  if settings.DEBUG:
      import debug_toolbar
      urlpatterns = [
          path('__debug__/', include(debug_toolbar.urls)),
      ] + urlpatterns
  

3. 版本兼容性与依赖检查 #

• 核对Django和Debug Toolbar的版本匹配：
  不同Django版本对应不同的Debug Toolbar版本，比如Django 4.x要配Debug Toolbar 4.x，Django 3.x配3.x。用下面的命令查看当前版本：

  pip show django debug-toolbar
  

  版本不匹配的话，卸载重装对应版本：

  pip uninstall debug-toolbar
  pip install debug-toolbar==4.2.0  # 替换成和Django匹配的版本号
  

• 检查依赖完整性：
  运行pip check查看是否有缺失的依赖包，比如sqlparse，缺失的话直接用pip install安装即可。

4. 静态文件与浏览器问题 #

• 生产环境需收集静态文件：
  如果是DEBUG=False的生产环境，必须运行python manage.py collectstatic，把Debug Toolbar的静态文件（css、js）收集到指定目录。开发环境下Django会自动处理，不用这一步。
• 检查浏览器静态文件加载情况：
  打开浏览器开发者工具的Network标签，看Debug Toolbar相关的静态文件是否加载失败。如果失败，检查settings.py里的STATIC_URL和STATIC_ROOT配置是否正确。

5. 其他常见问题排查 #

• 缓存中间件冲突：
  如果MIDDLEWARE里有django.middleware.cache.UpdateCacheMiddleware，Debug Toolbar的中间件要放在它后面；如果有FetchFromCacheMiddleware，则要放在它前面。
• 确认DEBUG模式已开启：
  Debug Toolbar只在DEBUG=True时生效，检查settings.py里的DEBUG值是否为True，生产环境别开这个模式。

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