starlette 本身不包含热重载逻辑,而是依赖第三方库 uvicorn 的 --reload 参数来实现。在开发环境中启动服务时,只需在命令中加上该标志,uvicorn 就会监控代码文件的变化并自动重启进程。

如何配置 uvicorn 以启用热重载
要启用热重载,需要在运行 uvicorn 时显式指定 --reload 选项。这会让 uvicorn 启动一个主进程来监控文件,并在检测到变化时向工作进程发送信号以重启。默认情况下,它只监控当前目录下的 Python 文件,可以通过 --reload-dir 指定其他目录。

uvicorn main:app --reload
上述命令会启动 Starlette 应用并开启监控。当修改了 main.py 中的代码并保存后,终端会显示 “Restarting...” 字样,随后服务自动重启,新代码生效。无需手动停止和重新启动服务。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
热重载对调试和性能的影响
热重载仅适用于开发环境,因为它会增加内存占用并略微降低启动速度。在生产环境中不应使用此功能,因为频繁的进程重启会导致服务不稳定且无法利用多进程优势。此外,热重载不会重新加载全局变量或静态资源,仅针对 Python 模块进行重载。若需监控非 Python 文件(如模板),需额外配置 --reload-dir。

uvicorn main:app --reload --reload-dir templates/
通过添加 --reload-dir templates/,uvicorn 会同时监控 templates/ 目录下的文件变化。这在开发动态模板时非常有用,确保模板更新后能触发服务重启。注意,这种机制依赖于文件系统事件,对于网络挂载或大型项目可能不够灵敏。
基于 uvicorn reload 参数的具体行为问题
当使用 --reload 时,uvicorn 会创建一个子进程来执行实际的应用逻辑,而主进程负责监控。如果应用中有长时间运行的任务或后台线程,它们可能在重启时被中断。因此,确保应用状态可恢复或使用外部队列处理关键任务是必要的。此外,环境变量和全局单例对象在重启后会重置,需避免依赖持久化内存。

















