升级Django与Python后热重载失效，服务器卡住无法自动重启

核心排查方向 #

• 检查文件系统权限
  StatReloader依赖文件系统状态变更通知，确认项目目录及子文件对当前运行用户具备完整的读写权限，尤其是修改的文件所在路径。
• 切换重载器类型
  Django 4.2默认使用StatReloader，可强制切换为其他重载器测试：
  • 安装watchman后使用WatchmanReloader：

    pipenv run python src/manage.py runserver {host}:{port} --reloader=watchman
    

  • 切换为AutoReloader：

    pipenv run python src/manage.py runserver {host}:{port} --reloader=auto
    

• 排查第三方库兼容性
  检查项目中依赖文件系统事件的第三方库（如自定义中间件、文件监控工具），确认其是否适配Python 3.11的文件API变化。
• 重建虚拟环境
  删除现有pipenv虚拟环境后重新构建，确保所有依赖针对Python 3.11重新安装：

  pipenv --rm
  pipenv install --python 3.11
  

• 验证忽略配置
  检查.gitignore或Django的IGNORABLE_FILE_NAMES设置，确认未误包含需要重载的文件类型（此情况概率较低，因日志已检测到文件变更）。

调试技巧 #

• 临时修改Django源码调试：在django/utils/autoreload.py的StatReloader类相关方法中添加打印语句，跟踪重载流程卡在哪个环节。
• 单独测试文件监听：编写简单Python脚本，用os.stat监控目标文件的修改时间，验证系统层面是否能正常检测到文件变更。

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