为什么Wagtail的PASSWORD_REQUIRED_TEMPLATE不生效，覆盖login.html却正常？

云原生阿岚

2026-10-16

核心遗漏配置检查项

首先需在项目settings.py中显式声明PASSWORD_REQUIRED_TEMPLATE配置，配置值为自定义模板相对于应用templates目录的相对路径，而非文件系统的绝对路径：
例如你将模板放在website/templates/password_required.html，对应配置为：
```
PASSWORD_REQUIRED_TEMPLATE = "password_required.html"
```
如果你将模板放在website/templates/website/password_required.html，对应配置为：
```
PASSWORD_REQUIRED_TEMPLATE = "website/password_required.html"
```
确认你的website应用在INSTALLED_APPS列表中的排序在wagtail.core（Wagtail 3.x及更早版本）或wagtailcore（Wagtail 4.x及更高版本）之前。Django的模板查找逻辑会按照INSTALLED_APPS的加载顺序优先匹配靠前应用的模板，你的自定义应用排在Wagtail核心应用前才能让自定义模板优先生效。
确认项目TEMPLATES配置项中的APP_DIRS参数值为True，确保Django会自动扫描每个已注册应用下的templates目录查找模板文件。
注意Linux/macOS等系统对文件名大小写敏感，检查模板文件名是否和配置中的拼写完全一致，避免大小写不匹配导致加载失败。