使用Docker版Cookiecutter创建的Django Admin页面异常求助

以下是针对该问题的排查方向和解决办法：

• 检查根路由配置
  确认项目根目录下的urls.py中，admin路由是否正确配置且未被其他路由覆盖：

  from django.contrib import admin
  from django.urls import path
  
  urlpatterns = [
      path('admin/', admin.site.urls),  # 确保这一行存在且位置在其他通配符路由之前
      # 其他路由...
  ]
  

  如果有path('', include('xxx.urls'))这类通配路由放在admin路由之前，会优先匹配导致admin子路由无法被正确解析。

• 验证模型Admin注册
  检查对应App下的admin.py，确认所有需要在后台显示的模型都已正确注册：

  from django.contrib import admin
  from .models import YourModel
  
  admin.site.register(YourModel)  # 确保模型已注册，无语法错误
  

  部分Cookiecutter模板可能不会自动为新生成的模型添加注册代码，需手动补充。

• 检查APPEND_SLASH配置
  在settings.py中确认APPEND_SLASH = True（Django默认值），如果被设置为False，admin子路由的斜杠后缀缺失会导致404，因为Django不会自动重定向带斜杠的URL。

• 排查FORCE_SCRIPT_NAME设置
  若settings.py中配置了FORCE_SCRIPT_NAME（用于设置URL前缀），需确保admin路由与该前缀匹配。例如：

  # settings.py
  FORCE_SCRIPT_NAME = '/myapp'
  
  # urls.py
  urlpatterns = [
      path(f'{settings.FORCE_SCRIPT_NAME}/admin/', admin.site.urls),
      # 其他路由...
  ]
  

  错误的前缀配置会导致admin子路由生成错误，引发404。

• 检查自定义中间件干扰
  暂时禁用项目中所有自定义中间件（在settings.py的MIDDLEWARE列表中注释掉自定义项），重新启动容器后测试admin链接。若问题消失，说明某中间件修改了请求路径或干扰了路由匹配，需逐一排查中间件代码。

• 验证静态文件收集（辅助排查）
  虽然直接导致404的概率较低，但需确认Docker启动命令中是否执行了静态文件收集：

  python manage.py collectstatic --noinput
  

  缺失静态文件可能导致admin页面渲染异常，间接影响链接跳转逻辑。

内容的提问来源于stack exchange，提问作者Kevin B.