Uvicorn --reload无日志、不重启，根本原因是PyCharm绿色按钮直接执行python main.py，绕过uvicorn监听逻辑；必须配置Run Configuration，指定uvicorn为脚本、参数含main:app --reload、工作目录为项目根目录、解释器选对虚拟环境。
Uvicorn --reload 无日志、不重启，改完代码还是旧逻辑
这是最典型的重载失效现象：保存后终端没输出 INFO: Reloading triggered by changes，浏览器刷新仍返回旧响应。根本原因不是你漏写了参数，而是 uvicorn 的文件监听机制在当前环境被静默绕过或拦截。
- PyCharm 2024+ 或 VSCode 某些配置下，
--reload会因进程模型冲突而“假启用”——命令里写了，但实际没 fork 子进程监听文件 - 新版 uvicorn（如
0.29.x、0.52.1）在 Windows / macOS 文件系统事件监听上存在兼容性退化，尤其配合watchfiles时容易丢变更 - 别信“升级就能解决”：实测
uvicorn==0.23.0和0.27.0在 PyCharm 中同样大概率失效；最稳的是uvicorn==0.20.0 - 执行降级命令：
pip install uvicorn==0.20.0 --force-reinstall，然后用终端跑uvicorn main:app --reload --port 8001验证
PyCharm 点绿色三角按钮启动，--reload 完全不走 uvicorn 流程
直接运行 main.py 文件（哪怕里面写了 uvicorn.run(..., reload=True)），PyCharm 实际执行的是 python main.py，而非 uvicorn 命令。热重载逻辑压根没加载，因为 uvicorn 的 reload 依赖于它自己的进程派生和信号捕获机制。
- 必须新建 Run Configuration：Type 选 “Python”，Module name 填
uvicorn（不是你的脚本名） - Parameters 填完整命令，例如：
main:app --reload --host 0.0.0.0 --port 8001 - Working directory 必须设为
main.py所在目录（否则 import 失败） - Python interpreter 要指向项目虚拟环境，不能是系统 Python
- 禁用 PyCharm 的 “Modify option to restart process on file change”——这个开关对 ASGI 应用无效，且可能干扰真实 reload
改了代码，reload 触发了但接口还是旧的
终端出现 INFO: Reloading triggered by changes，说明监听生效，但新逻辑没体现，常见于 FastAPI 初始化阶段的结构固化问题。
Uvicorn 0.52.1
下载
Uvicorn 0.52.1 是 Python ASGI Web 服务器，提供异步应用服务及 WebSocket 支持，常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包，可使用 pip 安装，并由包管理器处理所需依赖。
- FastAPI 的路由、中间件、依赖注入等都在
app = FastAPI()实例化时注册完成；reload 是整个进程重启，但如果你把 app 创建写在函数里、或用了单例缓存、或模块级全局变量（如数据库连接池未关闭），旧状态可能残留 - 检查是否误用了
--reload-dir：默认扫描整个工作目录，若venv/或.git/下有变动（比如 git auto-commit），也会触发 reload，但此时你没改业务代码，容易误判 - 避免在
main.py顶层写耗时初始化（如加载大模型、读取巨量配置）——reload 后会重复执行，拖慢响应，甚至导致 OOM - 验证方法：只改一行
return {"msg": "old"}→"new"，保存后立刻 curl 或刷新，响应必须变；否则说明 reload 没真正加载新模块
fastapi dev 和 uvicorn --reload 行为差异导致的“假失效”
fastapi dev 默认绑定 127.0.0.1，而很多人在局域网设备或容器里测试，误以为 reload 没生效，其实是服务根本没暴露出去。
-
fastapi dev：默认--host 127.0.0.1，适合本机开发；想局域网访问，必须显式加--host 0.0.0.0 -
uvicorn main:app --reload：默认也是127.0.0.1，不是0.0.0.0；要外网可访问，一定得加--host 0.0.0.0 - 别混用
--reload和--workers：uvicorn 明确警告"workers" flag is ignored when reloading is enabled，多进程模式与文件监听机制互斥 - 生产环境绝对禁用
--reload：它会持续 fork 子进程监听文件，增加 CPU 占用，且重启瞬间服务不可用
重载机制本身不复杂，但失效点分散在环境、IDE 配置、命令写法、版本兼容多个层面。最容易被忽略的是：你以为自己在用 uvicorn 的 reload，其实 PyCharm 根本没调它；或者你以为 reload 成功了，其实只是进程重启了，但 FastAPI 的初始化逻辑让旧状态“粘”住了。
