Django FlatPages仅显示单页求助：多页创建后模板仅展示一页且部分页面404

一、模板仅显示单个页面的问题 #

• 检查站点绑定：进入Django后台，查看两个FlatPage的Site字段，确认都绑定了当前访问的站点（比如127.0.0.1:8000或配置的域名）。默认get_flatpages标签只会返回与当前站点关联的页面，未绑定的会被过滤。
• 强制获取所有站点的页面：如果不需要按站点过滤，修改模板标签为：

  {% load flatpages %}
  {% get_flatpages for any as about_pages %}
  {% for page in about_pages %}
      <a class="navbar-item" href="{{ page.url }}">{{ page.title }}</a>
  {% endfor %}
  

• 确认标签加载：确保模板开头已加载flatpages标签，即{% load flatpages %}。

二、en-US页面404的问题 #

• 校验URL格式：确认en-US页面的url字段严格为/pages/en-US/about/privacy/（包含首尾斜杠，Django FlatPages对URL匹配是精确匹配）。
• 检查路由配置：在项目根urls.py中确认FlatPages的路由配置正确，且优先级高于其他可能冲突的路由：

  from django.contrib.flatpages import views
  
  urlpatterns = [
      # 其他路由...
      path('pages/<path:url>', views.flatpage),
  ]
  

• 验证站点关联：en-US页面必须绑定到当前访问的站点，否则FlatPages视图会直接返回404。
• 排查国际化冲突：如果开启了i18n，检查settings.py中的LANGUAGE_CODE、LANGUAGES配置是否包含en-us，且语言前缀路由未与FlatPage的URL路径冲突。

三、通用排查动作 #

• 清理缓存：执行python manage.py clearcache，排除Django缓存导致的数据不一致问题。
• 绕过模板标签测试：在自定义视图中直接查询并传递FlatPage数据，验证是否是模板标签的问题：

  from django.contrib.flatpages.models import FlatPage
  from django.shortcuts import render
  
  def test_flatpages(request):
      all_pages = FlatPage.objects.all()
      return render(request, 'test.html', {'all_pages': all_pages})
  

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