📚 课程目录第1章 FastAPI最小可运行服务搭建

1. FastAPI最小可运行服务搭建

本案例将创建一个最小可运行的 FastAPI 应用，提供根路径 / 的 HTTP 接口，访问时返回文本 Hello World。完成后可通过浏览器或命令行工具验证服务已在本地运行。

首先需要安装 FastAPI 和 Uvicorn（ASGI 服务器）。在终端执行以下命令：

pip install fastapi uvicorn

然后创建应用文件 main.py，代码如下：

from fastapi import FastAPI

app = FastAPI()

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

在终端启动服务：

uvicorn main:app --reload

启动后，Uvicorn 默认监听 http://127.0.0.1:8000。访问根路径即可看到返回的 JSON 数据。

FastAPI() 创建应用实例；@app.get("/") 将函数绑定到 HTTP GET 请求的根路径；函数返回的字典会自动序列化为 JSON 响应。此实现覆盖了“返回 Hello World”和“本地运行”两个核心目标，未包含额外路由或业务逻辑。

服务启动后，在浏览器打开 http://127.0.0.1:8000，页面应显示：

{"message":"Hello World"}

或在另一个终端使用 curl 命令验证：

curl http://127.0.0.1:8000/

预期输出与浏览器一致。同时可访问 http://127.0.0.1:8000/docs，FastAPI 会自动提供交互式 API 文档页面，能列出 / 路径及其 GET 方法，这也可作为服务正常工作的辅助确认。

上图展示了客户端通过 HTTP GET 请求访问 Uvicorn 监听的本地端口，FastAPI 应用处理请求并返回 JSON 数据的过程。判定标准为：浏览器或 curl 返回的响应体与预期输出完全一致，且服务进程无报错退出。