Docker中访问Django Admin容器退出码245问题排查求助

你遇到的这个问题确实挺棘手：在OSX 10.15.3上用Docker跑Django3.0.3，主页面访问一切正常，但一打开/admin路径就直接崩容器，只显示exit code245还没详细日志。你已经定位到base.py里的response.render()和中间件加载的疑点，这个方向非常对，咱们一步步深挖下去：

1. 先排除自定义/第三方中间件的干扰 #

从你的MIDDLEWARE配置和调试记录来看，有几个中间件可能是突破口：

• 暂时注释自定义StoreAnnee中间件：这个中间件在非登录请求时虽然没做特殊处理，但访问/admin会触发完整的中间件流程，会不会是request.session操作或者Parametre模型查询隐藏了问题？比如数据库连接在admin请求时出现异常？先注释掉它，重启容器测试/admin。
• 关闭Debug Toolbar中间件：debug_toolbar和runserver_plus（Werkzeug）偶尔会有兼容性问题，尤其是旧版本搭配Django3.0。把debug_toolbar.middleware.DebugToolbarMiddleware注释掉，再试/admin访问。
• 移除Reversion中间件：reversion.middleware.RevisionMiddleware会对请求做版本追踪，会不会在处理admin的模型列表时触发了未预期的错误？先临时移除它看看效果。

2. 验证中间件加载流程是否正常 #

你怀疑load_middleware()没被调用，咱们直接加日志验证：

• 找到本地挂载的django/core/handlers/base.py文件（因为你用了volume映射，本地修改会同步到容器），在load_middleware()方法的开头和结尾分别加两行打印：

  print("=== Starting to load middleware ===")
  # 原方法代码...
  print(f"=== Loaded template response middleware: {self._template_response_middleware} ===")
  

• 重启容器后，先访问主页面，看控制台会不会输出这两行日志；再访问/admin，对比日志差异。如果/admin请求时没输出，说明请求根本没走到中间件加载的完整流程，那问题可能出在URL路由或者admin的初始化阶段。

3. 替换runserver_plus为普通runserver测试 #

容器崩溃的exit code245大概率和进程收到异常信号有关，runserver_plus基于Werkzeug，会不会是它和某个组件的兼容性问题？

• 修改docker-compose.yml里的web服务命令：

  command: python3 -u manage.py runserver 0.0.0.0:8000
  

• 重启容器后访问/admin，如果不再崩溃，说明问题出在Werkzeug（runserver_plus依赖）和Django3.0.3的版本匹配上。检查你的requirements.txt里的Werkzeug版本，Django3.0.3建议搭配Werkzeug 0.16.x或1.0.x版本，过高或过低都可能出问题。

4. 进入容器内部做交互式调试 #

Docker日志可能会丢失一些关键信息，直接进容器调试更直观：

• 执行命令进入web容器：

  docker-compose exec web bash
  

• 开启Python错误追踪，手动启动服务：

  export PYTHONFAULTHANDLER=1
  python manage.py runserver_plus --nopin 0.0.0.0:8000
  

• 本地访问/admin，这时崩溃的调用栈会直接输出到控制台，能看到具体是哪个函数、哪个模块触发的错误。
• 另外，也可以在容器里启动Django shell，手动测试admin的初始化：

  from django.contrib.admin import site
  # 模拟一个空request对象
  from django.http import HttpRequest
  req = HttpRequest()
  site.get_app_list(req)
  

  如果这一步崩溃，说明问题出在admin加载模型列表的过程中，比如某个模型的__str__方法、admin配置有问题，或者第三方ORM扩展（比如reversion）出了段错误。

5. 检查Locale配置的影响 #

你的Dockerfile里强制设置了fr_FR.UTF-8的locale，会不会是admin页面的模板渲染时，locale处理触发了异常？

• 暂时注释Dockerfile里的locale相关配置：

  # RUN apt-get update && apt-get -y install locales
  # COPY locale.gen /etc/
  # RUN locale-gen fr_FR.UTF-8
  # ENV LANG fr_FR.UTF-8
  # ENV LANGUAGE fr_FR:fr
  # ENV LC_ALL fr_FR.UTF-8
  

• 重新构建镜像，重启容器，看/admin访问是否正常。如果恢复，说明是locale和Django的翻译系统不兼容导致的崩溃。

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