fastapi访问接口404 405

### FastAPI 接口访问时出现 404 和 405 错误的原因分析 当使用 FastAPI 构建 API 并遇到 404 或 405 错误时，通常是因为请求路径或方法不匹配所定义的路由配置。以下是可能原因及其解决方案： #### 1. 路由未正确定义 如果请求的 URL 不匹配任何已注册的路由，则会返回 404 Not Found 错误。确保在应用中正确设置了所需的端点。 ```python from fastapi import FastAPI app = FastAPI() @app.get("/example") # 定义 GET 方法的 /example 路径 def read_example(): return {"message": "This is an example"} ``` 上述代码仅支持 `GET` 请求到 `/example` 路径。如果尝试通过其他 HTTP 方法（如 POST）访问该路径，则会触发 405 Method Not Allowed 错误[^1]。 --- #### 2. HTTP 方法冲突 FastAPI 对每种 HTTP 方法都进行了严格区分。如果试图用错误的方法调用某个端点，也会引发 405 错误。例如，下面的代码只允许 `POST` 请求： ```python @app.post("/create-item/") async def create_item(item: dict): return item ``` 此时，发送 `GET` 请求至 `/create-item/` 将导致 405 错误。因此，在客户端发起请求前需确认使用的 HTTP 方法与服务器端一致。 --- #### 3. 动态参数缺失或错误 动态路径参数可能导致 404 错误。例如，以下代码期望接收一个名为 `{item_id}` 的变量作为路径的一部分： ```python @app.get("/items/{item_id}") def get_item(item_id: int): return {"item_id": item_id} ``` 如果没有提供有效的 `item_id` 值或者拼写有误，就会收到 404 错误响应。务必验证传入的 URL 是否符合预期格式。 --- #### 4. 中间件拦截行为 某些情况下，自定义中间件可能会阻止特定类型的请求到达目标处理函数。检查是否有类似的逻辑干扰正常流程： ```python from starlette.middleware.base import BaseHTTPMiddleware class CustomMiddleware(BaseHTTPMiddleware): async def dispatch(self, request, call_next): response = await call_next(request) if request.url.path.startswith('/blocked'): raise HTTPException(status_code=403, detail="Access Denied") return response ``` 此示例展示了如何利用 Starlette 提供的基础类实现简单的过滤机制。如果有不当设置，也可能间接造成 404 或者 405 报错现象发生。 --- #### 5. CORS 设置问题 跨域资源共享(CORS)策略限制了哪些外部站点可以安全地交互当前 Web 应用的数据资源。如果不适当地调整这些规则，浏览器环境下的 AJAX/Fetch 操作容易遭遇权限拒绝状况(表现为状态码异常)，尽管实际后端层面并无明显差池存在: ```python from fastapi.middleware.cors import CORSMiddleware origins = ["*"] # 允许所有源；生产环境中应更具体化列表项内容！ app.add_middleware( CORSMiddleware, allow_origins=origins, allow_credentials=True, allow_methods=["*"], allow_headers=["*"] ) ``` 以上片段说明了启用全局范围内的 CORS 支持方式之一。注意依据项目需求灵活修改相关属性值以满足最佳实践标准[^2]。 --- ### 总结建议 针对上述提到的各种可能性逐一排查定位根本诱因所在之后再采取相应措施加以修正即可有效减少乃至彻底消除此类常见报错情形的发生几率。