### FastAPI 中不使用 ORM 的分层设计 在 FastAPI 项目中，如果选择不使用 ORM 而直接通过原生数据库连接操作数据，则需要更加清晰地划分项目的各层次结构。以下是常见的分层设计方案： #### 1. **路由层 (Router Layer)** 路由层负责接收 HTTP 请求并将其传递到对应的处理函数。这一层应保持简洁，仅用于定义路径参数、查询参数以及请求体等内容。 ```python from fastapi import APIRouter, Depends router = APIRouter() @router.get("/items/{item_id}") def read_item(item_id: int, db=Depends(get_db_connection)): item = get_item_by_id(db, item_id) if not item: raise HTTPException(status_code=404, detail="Item not found") return {"item": item} ``` 此部分依赖于 `get_db_connection` 函数来获取数据库连接[^2]。 --- #### 2. **服务层 (Service Layer)** 服务层是业务逻辑的核心所在。它封装了具体的业务规则，并调用底层的数据访问方法完成实际的操作。 ```python def get_item_by_id(db, item_id: int): query = f"SELECT * FROM items WHERE id = {db.escape(item_id)}" result = db.execute(query).fetchone() return dict(result) if result else None ``` 这里需要注意 SQL 注入防护机制，通常可以通过数据库驱动自带的转义功能实现[^3]。 --- #### 3. **数据访问层 (Data Access Layer)** 数据访问层专注于与数据库交互的具体细节，比如执行原始 SQL 查询或存储过程。该层屏蔽了其他层对于具体数据库技术栈的认知需求。 ```python import pymysql.cursors def get_db_connection(): connection = pymysql.connect( host='localhost', user='root', password='password', database='test_db', cursorclass=pymysql.cursors.DictCursor, ) try: yield connection finally: connection.close() ``` 上述代码展示了如何创建一个基于 PyMySQL 的上下文管理器以提供安全可靠的数据库会话支持[^4]。 --- #### 4. **异常处理层 (Error Handling Layer)** 为了提升用户体验，在遇到错误时需返回标准化的消息格式而非堆栈跟踪信息。可以自定义全局中间件或者装饰器来进行统一捕获和响应构建。 ```python from starlette.requests import Request from starlette.responses import JSONResponse @app.exception_handler(Exception) async def http_exception_handler(request: Request, exc: Exception): return JSONResponse({"error": str(exc)}, status_code=500) ``` 这种做法有助于减少重复代码量的同时也增强了系统的可维护性[^5]。 --- #### 5. **配置管理层 (Configuration Management Layer)** 最后但同样重要的是环境变量加载环节。推荐利用第三方库如 Python-dotenv 来简化敏感信息读取流程。 ```python from pydantic import BaseSettings class Settings(BaseSettings): DB_HOST: str DB_USER: str DB_PASS: str DB_NAME: str settings = Settings(_env_file=".env", _env_file_encoding="utf-8") ``` 这样做的好处是可以轻松切换不同部署场景下的设置而无需修改源码本身[^6]。 --- ### 总结 以上就是在 FastAPI 应用程序里不用 ORM 只依靠传统关系型数据库接口编程时建议遵循的一种架构模式。每一级都有其特定职责范围从而促进了模块化开发理念落地实践。