fastapi应用启动时报“连接被拒绝”错误,通常是因为在服务器尚未启动时就执行了客户端请求代码,导致请求无法建立连接。本文将详细解释该问题的根本原因,并提供正确的部署与测试方法。
在您提供的 FastAPI 示例中,问题核心在于服务端代码与客户端调用逻辑混写在同一文件中。具体来看:
# ... FastAPI 路由定义 ...
@app.post("/predict")
def predict_route(data: List[float]):
prediction = predict(data)
return {"prediction": prediction}
# ❌ 错误:此处立即发起 HTTP 请求
import requests
f = open('test_data.json')
data = json.load(f)
response = requests.post("http://localhost:8000/predict", json=data) # ← 此行在 uvicorn 启动前就执行!
print(response.json())
当您运行 uvicorn main:app –reload 时,Python 会自上而下执行整个 main.py 文件。这意味着:
- requests.post(…) 会在 FastAPI 应用监听 http://localhost:8000 之前就被触发;
- 此时端口 8000 尚未被占用,系统返回 [WinError 10061](Windows)或 ConnectionRefusedError(Linux/macOS),即“目标机器主动拒绝连接”。
✅ 正确做法是:分离服务端与客户端逻辑。
✅ 推荐方案:拆分为两个独立文件
1. app.py(纯服务端)
from fastapi import FastAPI
import pickle
import numpy as np
from typing import List
app = FastAPI()
def predict(data: List[float]):
with open("model.pkl", "rb") as f:
model = pickle.load(f)
data = np.array(data).reshape(1, -1)
prediction = model.predict(data).tolist() # .tolist() 确保 JSON 可序列化
return prediction
@app.post("/predict")
def predict_route(data: List[float]):
return {"prediction": predict(data)}
启动服务: