FastAPI项目启动与配置教程

1. 项目目录结构及介绍

本项目是基于FastAPI框架的一个模板项目，目录结构如下所示：

fastapi-mcp-langgraph-template/
├── app/                         # 应用程序目录
│   ├── __init__.py              # 初始化文件
│   ├── main.py                  # FastAPI 应用启动和路由定义
│   ├── dependencies.py          # 依赖注入模块
│   └── models.py                # 数据模型模块
├── tests/                       # 测试目录
│   ├── __init__.py
│   └── test_main.py             # 测试 main.py 中的功能
├── alembic/                     # 数据库迁移目录
│   ├── env.py
│   ├── README                   
│   └── versions/                
├── migrations/                  # 数据库迁移脚本目录
│   └── __init__.py
├── requirements.txt             # 项目依赖的第三方库
└── README.md                    # 项目说明文件

• app/: 包含应用程序的主要代码。
• app/__init__.py: 初始化应用程序包。
• app/main.py: 定义 FastAPI 应用程序实例和路由。
• app/dependencies.py: 定义应用程序依赖项。
• app/models.py: 定义数据模型。
• tests/: 包含测试应用程序的代码。
• alembic/: 包含数据库迁移脚本和配置。
• migrations/: 包含数据库迁移的版本控制文件。
• requirements.txt: 列出项目运行所依赖的Python库。
• README.md: 提供项目的基本信息。

2. 项目的启动文件介绍

项目的启动文件为 app/main.py，以下是该文件的主要内容：

from fastapi import FastAPI
from .dependencies import get_db
from .models import models
from . import crud
from sqlalchemy.orm import Session

app = FastAPI()

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

@app.get("/items/{item_id}")
def read_item(item_id: int, db: Session = Depends(get_db)):
    # 这里会使用数据库会话和item_id来获取项目信息
    pass

在这个文件中，我们创建了一个 FastAPI 实例，并定义了一些路由。每个路由都对应一个处理函数，这些函数负责处理客户端的请求。

3. 项目的配置文件介绍

本项目中的配置文件是通过环境变量和代码中的配置类进行管理的。虽然没有一个单独的.env文件，但是app/main.py 和 app/dependencies.py 中使用环境变量来配置一些参数。

例如，在 app/dependencies.py 中可能有一个获取数据库会话的依赖项：

from sqlalchemy.orm import sessionmaker
from sqlalchemy import create_engine

# 假设DATABASE_URL是存储数据库连接信息的环境变量
DATABASE_URL = "sqlite:///./test.db"

# 创建数据库引擎
engine = create_engine(DATABASE_URL)

# 创建Session类
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)

def get_db():
    db = SessionLocal()
    try:
        yield db
    finally:
        db.close()

在这个例子中，数据库连接信息存储在环境变量 DATABASE_URL 中，然后通过 create_engine 创建一个数据库引擎，最后使用这个引擎来创建一个会话工厂 SessionLocal。get_db 函数用于获取数据库会话，并在请求结束时关闭会话。这样可以通过依赖注入的方式在路由处理函数中使用数据库会话。