根路径由应用代码定义而非Uvicorn配置；--root-path仅用于反向代理子路径场景，需FastAPI同步设置root_path；app.mount("/")会冲突并覆盖所有路由，应挂载子路径如"/static"；--host/--port不影响路径路由。
根路径不是 uvicorn 的配置项，而是应用层路由问题
Uvicorn 本身不处理“根路径”（/）的响应内容，它只负责把 HTTP 请求转发给你的 ASGI 应用（比如 FastAPI 的 app 实例）。所谓“配置根路径”，其实是让你的应用代码定义 @app.get("/") 这类路由。如果你启动后访问 http://localhost:8000/ 得到 404，问题一定出在应用代码没声明根路由，而不是 uvicorn 启动参数没设对。
uvicorn 启动时的 --root-path 是反向代理场景专用
这个参数容易被误解为“设置网站首页路径”，但它真实作用是：告诉 Uvicorn 当前服务实际部署在反向代理（如 Nginx、Cloudflare）后面的子路径下，比如 https://example.com/api/。此时你需要让 Uvicorn 知道“我对外的 URL 前缀是 /api”，否则生成的重定向地址、静态文件链接、OpenAPI 文档路径都会出错。
-
--root-path /api：Uvicorn 会把所有相对路径自动补上前缀，例如RedirectResponse("/login")变成跳转到/api/login - FastAPI 需同步配置：
app = FastAPI(root_path="/api")，否则 OpenAPI UI 的请求地址仍按/构造 - 该参数不影响你代码里怎么写
@app.get("/")——它还是匹配GET /api/这个完整路径 - 本地开发直连
:8000时完全不需要这个参数；加了反而会让浏览器访问http://localhost:8000/时返回 404（因为实际要访问http://localhost:8000/api/）
静态文件挂载的根路径陷阱：app.mount() 不等于网站根目录
很多人想“把 static/ 目录变成网站根”，于是写 app.mount("/", StaticFiles(directory="static"), name="static")。这会导致两个严重问题：
Uvicorn 0.52.1 是 Python ASGI Web 服务器，提供异步应用服务及 WebSocket 支持，常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包，可使用 pip 安装，并由包管理器处理所需依赖。
- Uvicorn 启动直接报错：
AssertionError: A route was added that overlaps with the root path，因为 FastAPI 默认的根路由（哪怕没定义）和mount冲突 - 即使绕过报错，所有其他路由（如
@app.get("/items")）将完全失效——mount会劫持所有以/开头的请求，优先交给静态文件处理器 - 正确做法是明确挂载子路径：
app.mount("/static", StaticFiles(directory="static"), name="static")，然后在 HTML 中引用/static/logo.png - 真要让某个 HTML 文件作为首页，应该用路由返回：
@app.get("/")里读取并返回index.html内容，而不是靠StaticFiles
为什么改了 --host 或 --port 没影响根路径行为
这些参数只控制 Uvicorn 绑定哪个网络地址和端口监听请求，和 URL 路由路径无关。常见误操作包括：
- 以为
uvicorn main:app --host 127.0.0.1 --port 3000会让根路径变成/3000——不会，/还是/ - 在 PyCharm Run Configuration 里把
Parameters写成main:app --root-path /——等价于没设，且可能干扰调试 - 检查
Working directory是否正确：如果路径错了，main.py加载失败，连根路由定义都执行不到，自然 404
最常被忽略的一点：Uvicorn 启动日志里显示的 Uvicorn running on http://0.0.0.0:8000，这个地址里的 / 是协议+主机+端口后的路径起点，它永远由你的应用代码决定，Uvicorn 只是把请求送到那里。
