后端开发做久了,你会发现一个特别真实的差距:同样一个订单接口,初级工程师三天写出来能跑,高级工程师五天写出来除了能跑,还能抗住流量波动、快速定位线上问题、在异常发生时给出体面的错误提示,而不是让调用方收到一坨看不懂的堆栈。这个差距不在业务逻辑本身,而在工程化能力。
今天这篇就以“Python 分层架构 + 中间件 + 日志 / 异常统一处理”为主线,从零讲清楚怎么把一个能用的小服务,升级成接近企业级标准的后端。内容偏实操,贴合真实业务场景,适合已经写过一些 Python Web 接口、想往项目工程化方向提升的同学,也适合团队里需要搭建后端基础框架的开发者。
1. 分层架构:先把代码的“地盘”划清楚
1.1 为什么必须分层
先聊一个最常见的反面案例。新项目起步时,时间紧、人少,大家图省事,业务逻辑直接写在路由函数里:
python复制# 反面教材
@app.post("/order/create")
def create_order(user_id: int, item_id: int, count: int):
# 校验参数
if count <= 0:
return {"code": 400, "msg": "count必须大于0"}
# 查数据库
item = db.execute(f"SELECT * FROM item WHERE id={item_id}").fetchone()
if not item:
return {"code": 404, "msg": "商品不存在"}
# 查用户
user = db.execute(f"SELECT * FROM user WHERE id={user_id}").fetchone()
if user["balance"] < item["price"] * count:
return {"code": 402, "msg": "余额不足"}
# 扣钱
db.execute(f"UPDATE user SET balance=balance-{item['price']*count} WHERE id={user_id}")
# 生成订单
db.execute(f"INSERT INTO order(user_id, item_id, count, total) VALUES(...)")
db.commit()
return {"code": 0, "data": {"order_id": 123}}
这段代码看着没毛病,但三个月之后你会想打自己。因为你会遇到:
- 另一处也要用“校验用户余额”,你会复制粘贴一遍;
- 下单接口里加了库存锁定,但库存服务在另一个工程,代码该放哪?
- 测试时发现每次都要手动构造数据库数据,根本没法做单元测试;
- 你甚至分不清哪些是 HTTP 协议的活儿、哪些是业务规则、哪些是数据存取。
分层的本质,是把“变化点”隔离开。谁容易变?外部协议(HTTP 接口)容易变,业务规则容易变,数据存储方式容易变。如果这一堆东西混在一个函数里,任何一方变动都会连坐其他代码。分层之后,每一层只干一件事,而且通过明确的依赖方向来控制变更的影响范围。
1.2 企业级 Python 项目最常见的四层
具体到 Python 后端,社区实践已经收敛出一套比较稳定的结构:
| 层次 | 职责 | 典型目录/模块 | 依赖方向 |
|---|---|---|---|
| 接口层 | 参数解析、认证、路由分发、HTTP 响应 | api/ 或 views.py、controllers/ |
依赖 service 层 |
| 业务层 | 业务规则、流程编排、事务边界 | service/ 或 services.py、use_cases/ |
依赖 repository 层 |
| 数据层 | SQL 拼装、ORM 操作、缓存访问 | repository/ 或 repositories.py、dal/ |
只依赖模型定义 |
| 模型层 | 数据表映射、领域对象、公共类型 | models/、schemas/ |
无上层依赖 |
项目大了之后,有些人还会在 service 之上再切一个 domain 领域层放纯逻辑(不加 IO),或者把 service 拆成 command/query。但入门工程化,先掌握这四层就够用。
有人会问:这和 MVC 有什么区别?MVC 更面向全栈框架,而这里的分层更强调依赖方向——这是工程化的关键。依赖必须是单向的:接口层调业务层,业务层调数据层,数据层不回头依赖上层。一旦出现业务层直接被路由函数绕过的情况,就是架构腐化的信号,就得靠 code review 或架构测试来守。
改造后,刚才的下单逻辑会变成这样:
python复制# 接口层只做参数解析,把业务交给 service
@app.post("/order/create")
def create_order(payload: CreateOrderRequest):
order_id = order_service.create_order(payload)
return {"code": 0, "data": {"order_id": order_id}}
python复制# 业务层做规则编排
class OrderService:
def __init__(self, user_repo, item_repo, order_repo):
self.user_repo = user_repo
self.item_repo = item_repo
self.order_repo = order_repo
def create_order(self, payload
