flatpages本质是数据库存html、动态查表渲染，并非生成静态文件；需配齐sites/flatpages、site_id、迁移建表及正确url配置，否则404。
Flatpages 不是用来“快速创建静态内容页”的快捷按钮，它本质是把 HTML 内容存进数据库、靠中间件或 URL 路由动态查表渲染——页面仍是动态响应，只是内容不写在模板里。真想生成 .html 文件扔给 Nginx，得另写脚本或用第三方库。
Flatpages 的核心依赖必须一次性配齐
漏掉任一环节，FlatpageFallbackMiddleware 会静默失效，访问 /about/ 直接 404：
-
INSTALLED_APPS里必须同时有'django.contrib.sites'和'django.contrib.flatpages' -
SITE_ID = 1必须显式写在settings.py中（不能靠默认值，Django 4.2+ 对此更严格） - 要么启用
FlatpageFallbackMiddleware，要么在urls.py显式注册views.flatpage—— 二者不可兼得，否则可能重复匹配或 500 - 运行
python manage.py migrate后，检查数据库是否生成了django_flatpage和django_flatpage_sites两张表
URL 配置方式决定行为边界
三种常见写法对应完全不同的路由逻辑，选错就找不到页面：
-
path('pages/', include('django.contrib.flatpages.urls'))：所有 flatpage 必须以/pages/xxx/开头，比如后台填的 URL 是/about/，实际要访问/pages/about/ -
re_path(r'^(?P<url>.*/)$', views.flatpage)</url>：作为兜底路由，放在urlpatterns最末尾；但若APPEND_SLASH = False，正则里的/必须删掉，否则/about匹配失败 -
path('about-us/', views.flatpage, {'url': '/about-us/'})：精确控制路径，适合少量固定页面；注意传入的url参数值必须带开头斜杠，且和后台录入的 URL 完全一致（包括末尾斜杠）
模板和权限控制容易被忽略的细节
Flatpages 默认只渲染 {{ flatpage.title }} 和 {{ flatpage.content }}，其他字段不自动注入：
- 自定义模板路径必须是
flatpages/default.html（不能是flatpages.html或其他名字），否则 fallback 到 Django 内置空白模板 -
registration_required = True在后台勾选后，未登录用户访问直接返回 404，不是重定向到登录页；如需跳转，得自己写中间件拦截或改用视图函数封装 -
template_name字段可指定独立模板（如flatpages/about.html），但该模板仍只能访问flatpage变量，无法自动拿到用户对象或上下文处理器数据 - 用
{% get_flatpages %}标签时，for someuser子句只过滤registration_required状态，不校验用户是否实际登录——需额外在模板中用{% if user.is_authenticated %}包裹
Flatpages 的真正价值不在“快”，而在“免开发”：不用写视图、不用建模型、不用配 URL，后台填完就能上线。但它对 URL 结构、权限粒度、模板扩展都有限制，一旦需求超出单字段 HTML 内容管理，就得切回自定义视图+模型的正统路径。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
