Docker中Django开发服务器os.getcwd()偶发FileNotFoundError原因排查

可能的根因 #

• Docker挂载目录的inode变更：如果Django项目目录使用Docker绑定挂载映射到宿主机，当宿主机对项目目录执行删除重建、批量文件替换等操作时，容器内项目目录的inode会发生变化。Python进程的当前工作目录（cwd）基于inode而非路径名记录，原inode对应的目录被销毁后，进程调用os.getcwd()就会因找不到原inode对应的目录而抛出错误。
• runserver自动重载的进程重启异常：python manage.py runserver开启自动重载后，会通过父进程监控文件变化，触发重载时终止当前子进程并启动新子进程。若重启过程中，容器内项目目录因挂载波动、文件同步延迟等问题，导致新进程启动时未正确绑定到有效目录，或者旧进程未完全退出仍在处理请求，就会出现cwd无效的情况。
• 隐式目录变更操作：虽然代码中未主动调用os.chdir()，但某些第三方库、Django内部组件（如模板编译、静态文件处理的临时操作）或多线程环境下的第三方依赖，可能在后台隐式修改了进程的当前工作目录，进而引发该错误。

python manage.py runserver是否会导致该问题 #

是的，runserver的自动重载机制是潜在诱因：

• 自动重载依赖进程重启流程，若重启时容器内项目目录的inode因挂载操作发生变化，新进程可能继承旧进程的无效cwd引用；
• 开发模式下runserver会频繁检测文件变化，若宿主机与容器的文件同步存在延迟，可能导致进程在目录状态不稳定时尝试获取cwd；
• 多线程模式下，进程内所有线程共享cwd，若重载过程中某个线程的操作意外修改了cwd，会影响所有线程的后续执行。

验证与解决建议 #

• 验证方法：出现错误时，在容器内执行ls -i <项目根目录路径>查看当前目录的inode，同时在Python进程中打印os.stat(os.getcwd()).st_ino（若能执行），对比两者是否一致——若不一致，即可确认是inode变更导致的cwd无效。
• 解决措施：
  • 替换os.getcwd()为Django内置的BASE_DIR（在settings.py中定义），直接使用硬编码的项目根目录路径，完全避免依赖进程cwd；
  • 在Docker启动命令中明确指定工作目录，例如：WORKDIR /app（Dockerfile）或启动命令前添加cd /app && ，确保进程启动时绑定到稳定的目录路径；
  • 优化宿主机的代码更新方式，避免直接删除重建项目目录，改用增量更新，减少inode变更的概率。

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