未找到uvicorn为404的FastAPI错误

在处理使用Uvicorn作为服务器运行FastAPI应用时遇到404错误，通常意味着客户端请求的资源在服务器上未找到。以下是关于这个问题的基础概念、可能的原因以及解决方案：

基础概念

FastAPI：一个现代、快速（高性能）的Web框架，用于构建API，基于Python 3.7+的类型提示。
Uvicorn：一个轻量级的ASGI服务器，用于部署Python web应用，特别适合与FastAPI一起使用。

可能的原因

路由定义错误：确保你的路由在FastAPI应用中正确声明。
请求路径错误：客户端请求的路径可能与服务器上定义的路径不匹配。
静态文件配置问题：如果尝试访问静态文件，确保静态文件路径配置正确。
部署配置问题：在生产环境中，可能由于Nginx或其他反向代理服务器的配置错误导致404。

解决方案

检查路由定义

确保你的FastAPI应用中的路由定义正确无误。例如：

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello World"}

验证请求路径

确认客户端发送请求的路径与服务器端定义的路径一致。例如，如果服务器端定义了/api/v1/items，则客户端应请求相同的路径。

静态文件服务

如果需要提供静态文件服务，可以使用StaticFiles类：

from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()

app.mount("/static", StaticFiles(directory="static"), name="static")

确保static目录存在，并且文件路径正确。

生产环境配置

在生产环境中，通常使用Nginx作为反向代理。确保Nginx配置正确，例如：

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

确保proxy_pass指向Uvicorn服务器的正确地址和端口。

示例代码

以下是一个完整的FastAPI应用示例，包括路由定义和静态文件服务：

from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()

app.mount("/static", StaticFiles(directory="static"), name="static")

@app.get("/")
async def root():
    return {"message": "Hello World"}

@app.get("/items/{item_id}")
async def read_item(item_id: int):
    return {"item_id": item_id}