Django密码修改时自定义模板被Django admin覆盖的问题
异常根因
自定义模板不加载、直接渲染admin内置页面的问题,核心是路由匹配规则触发了内置逻辑,和模板优先级的直接关系不大,配套截图展示的英文页面即为Django admin默认的密码修改页,无自定义页面元素:
- Django的url匹配是严格自上而下遍历的,第一个命中的路由规则会直接终止后续匹配,返回对应视图的渲染结果。
- 当前的url配置里,两条重复的
path('accounts/', include('django.contrib.auth.urls'))被放在了自定义路由的上方,这两个规则会把所有accounts/开头的路径全部拦截,包括自行定义的accounts/password_reset/路径。 - 写好的自定义密码修改视图因为排在路由列表最后,永远不会被匹配触发,系统实际执行的是auth内置的密码相关路由逻辑,自然就加载了admin关联的内置模板。
- 冗余的重复include配置没有任何实际作用:两次引入同一个auth的url集合,只是重复注册了相同的路由规则,还人为打乱了匹配顺序。
- 路径和视图存在错配:在
accounts/password_reset/路径下绑定PasswordChangeView(密码修改视图),本身就和内置auth路由的路径定义冲突。
可落地的修正步骤
- 调整路由的排序逻辑:把自定义的、需要优先匹配的路由放到内置auth路由的前面,保证自定义路径先被命中。
- 删掉冗余的重复include配置,只保留一次auth路由的引入即可,不需要重复写两次。
- 修正路径和视图的对应关系,按照实际功能匹配:如果要做密码修改功能,就把路径设置为
password_change/,对应绑定PasswordChangeView;如果要做密码重置功能,就换用PasswordResetView。 - 修正后的路由配置参考:
urlpatterns = [ path('', index, name='index'), path('registration/', registration, name='registration'), # 自定义高优先级路由放在最前面 path('accounts/password_change/', PasswordChangeView.as_view(template_name="password_change.html"), name='password_change'), # 内置auth路由放在后方做兜底 path('accounts/', include('django.contrib.auth.urls')), ]
模板加载优先级说明
完成路由修正后,如果还出现内置模板优先加载的问题,检查两点配置即可:
- 确认项目settings里的
TEMPLATES配置中APP_DIRS=True处于开启状态,Django会优先搜索项目根目录templates文件夹、各应用templates文件夹下的模板文件,自定义的password_change.html只要放在这些搜索路径下,就会自动覆盖auth内置的同名模板,不需要额外修改内置应用的配置。 - 不要把自定义模板文件放到django admin的模板目录下,避免和内置文件混淆。
内容的提问来源于stack exchange,提问作者user392170
相关产品推荐
相关产品推荐

