FastAPI本地部署时请求失败的常见原因与解决方案-Python教程

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)}

启动服务:

夏夕资源网专注于CMS网站模板,主流语言整站网站源码下载,网站建设相关教程分享,好用的软件素材整合下载,提供一站式便捷自助服务。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,默认解压密码为"zy.lucklyus.top",如遇到无法解压的请联系管理员!
夏夕资源网-网站模板_免费源码_资源素材 » FastAPI本地部署时请求失败的常见原因与解决方案-Python教程
在线时间:12:00 - 22:00
关注微信公众号:微信公众号
站长邮箱:[email protected]
  • 运营天数: 1393+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4030332+
  • 本周更新: 0+
  • 最后更新: 2026-03-16

本站指数

×
  • 运营天数: 1393+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4030332+
  • 本周更新: 0+
  • 最后更新: 2026-03-16