Django站点下拉菜单仅首页失效其他页面正常该如何排查？

最可能的原因1：静态资源引用路径错误 #

你大概率是用了相对路径引用下拉菜单依赖的JS/CSS文件（比如Bootstrap的交互脚本），示例如下：

<script src="../static/js/bootstrap.bundle.min.js"></script>

这类带../或者./的相对路径，在网站根路径（首页）下会解析到错误的资源地址，导致下拉菜单的交互逻辑无法触发；而在二级路径（比如/category-slug/）下，相对路径刚好能定位到正确的静态资源，所以功能正常。

• 解决方法：统一使用Django的static模板标签引用静态资源
  1. 所有用到静态资源的模板顶部添加{% load static %}
  2. 把资源引用路径改为如下格式：

  <link rel="stylesheet" href="{% static 'css/bootstrap.min.css' %}">
  <script src="{% static 'js/bootstrap.bundle.min.js' %}"></script>
  

可能的原因2：上下文处理器未生效、或视图逻辑冲突 #

你给出的home视图返回的上下文没有手动传入links变量，正常情况下配置正确的上下文处理器会自动给所有模板注入这个变量。如果出现以下情况会导致首页取不到links：

• 你确认过settings.py中TEMPLATES配置项的OPTIONS.context_processors列表里已经加了你的菜单上下文处理器（比如your_app.context_processors.menu_links），但其他页面的store视图里手动传入了links变量，一旦上下文处理器配置失效，只有走store视图的页面能正常拿到分类数据，首页就会显示空的下拉菜单。
• 解决方法：
  1. 再次核对上下文处理器的注册路径是否完全正确，没有拼写错误
  2. 可以直接在home视图的context里临时加一行'links': Category.objects.all()，如果加完之后首页下拉菜单恢复正常，就可以确定是上下文处理器配置的问题。

可能的原因3：模板继承错误 #

如果首页的home.html没有正确继承包含导航栏的公共基础模板，或是首页单独重写了导航栏代码，和其他页面用的不是同一段导航栏逻辑，也可能出现首页下拉菜单独有的异常。

• 解决方法：对比首页和其他正常页面的前端源码，核对下拉菜单的HTML结构、类名是否完全一致，排查是否有首页独有的语法错误。

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