Django认证页面出现模板外冗余Text Node的成因与解决

这个问题和django.contrib.auth.urls的路由逻辑本身没有关联，是两个行为叠加触发的：

• Django内置的所有密码修改、密码重置相关视图，全部继承自PasswordContextMixin，这类视图会默认向模板上下文注入title变量，对应值就是各页面的原生标题：密码修改页为Password Change、密码重置页为Password Reset，密码重置完成页、确认页等关联页面也会注入匹配的对应标题值
• 你在编写对应自定义模板时，存在未被任何HTML标签、模板块包裹的独立{{ title }}表达式，或是模板的块语法存在错误（比如块名拼写偏差、块标签未闭合），导致模板引擎渲染时，直接把title值作为无格式的文本节点输出到页面流的最前端，没有被任何HTML元素包裹，最终表现为页面左上角突兀的纯文本

登录页、其他业务页面不会出现这个问题，是因为对应的内置登录视图、自定义业务模板没有注入这个title上下文变量，也不存在独立的title表达式调用，自然不会输出这类冗余文本。

• 逐一检查所有和密码修改、重置相关的自定义模板文件，这类模板默认存放在应用下的templates/registration/目录，包含文件：password_change_form.html、password_change_done.html、password_reset_form.html、password_reset_done.html、password_reset_confirm.html、password_reset_complete.html
• 逐行排查每个文件的顶层代码：查找有没有脱离HTML标签、独立存在的{{ title }}表达式——这类无包裹的表达式会被模板引擎直接输出为文本节点，和浏览器元素检查看到的表现完全匹配
• 运行Django内置的模板校验命令python manage.py validate_templates，快速定位所有存在语法错误的模板：比如未闭合的块标签、块名和父模板不匹配的问题，这类问题会导致原本应该被块包裹的内容，因为块匹配失败，被提前输出到页面渲染流的开头

• 直接删除对应模板里未做任何包裹的独立{{ title }}表达式行：这是最常见的触发场景，很多人从旧版Django内置auth模板复制代码时，会把模板开头默认的title行一起带过来，没有做任何HTML包裹，删掉即可消除冗余文本
• 如果需要保留页面标题的展示效果，就把独立的{{ title }}放到对应语义的HTML标签内，比如<h1>{{ title }}</h1>，避免输出为无结构的纯文本节点
• 修正所有校验出的模板块语法错误：比如补全未闭合的块标签、修正拼写错误的块名，保证模板继承逻辑正常运行，避免内容因为块匹配失败被提前输出到页面主体区域

这也是为什么之前你用相同的路由和自定义模板开发时没有遇到问题：之前的自定义模板里要么没有写独立的{{ title }}表达式，要么模板块语法正常，title内容被正常包裹在页面head或主体的指定区域内，没有出现直接输出为纯文本节点的情况。

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