后端开发 — 一条业务规则只有一个家

一句话:后端的复杂度不在代码量,而在同一条规则被写了几遍;把它收敛到一个唯一的、可测试的位置,系统才开始可控。

🎯 这 20% 能解决哪些问题

你遇到的困惑本质原因马上能改的动作
同一个校验在三个接口里各写一遍业务规则散落在 Controller规则下沉到实体/领域服务,Controller 只调用
重复提交造成重复扣款没有幂等键,写操作不幂等建业务唯一键 + 唯一索引,重复请求返回首次结果
缓存和数据库不一致更新顺序错、没有失效策略先更新库再删缓存;对强一致场景直接读库
大事务锁表,接口超时事务里做了 RPC、发消息、写日志事务只包数据库写,副作用移出事务
流量高峰服务被打挂没有限流与降级入口限流 + 非核心功能可关闭
列表接口越用越慢N+1 查询与缺索引预加载关联,按查询条件建复合索引

一、一次请求的完整链路

sequenceDiagram
    participant C as 客户端
    participant G as 网关/Nginx
    participant A as 应用
    participant S as 领域服务
    participant D as 数据库
    participant R as 缓存/队列
    C->>G: HTTP 请求
    G->>A: 转发(鉴权、限流)
    A->>R: 读缓存
    alt 缓存命中
        R-->>A: 返回数据
    else 未命中
        A->>S: 执行用例
        S->>D: 读写(事务内)
        S->>R: 失效缓存 / 投递事件
        S-->>A: 业务结果
    end
    A-->>C: 统一响应
环节只做高频错误
网关鉴权、限流、路由、TLS把业务判断放网关
应用层参数校验、用例编排、事务边界写业务算法
领域层规则、状态迁移、不变量直接拼 SQL
数据层持久化、查询、缓存读写在 Repository 里写业务分支

二、事务边界:只包数据库写

原则做法原因
短事务事务内只做必要的 SQL长事务锁行、拖慢连接池
不在事务里做 RPC调用外部接口放到事务外外部超时会拖死本地事务
不在事务里发消息用本地事件表 / outbox,事务提交后再投递提交失败会导致消息与数据不一致
一次事务一个聚合跨聚合用状态机 + 补偿分布式事务成本远高于补偿
下单流程:事务内(写订单 + 扣减库存)→ 提交 → 事务外(发通知、投递队列、清缓存)

三、幂等:所有写接口的默认要求

场景幂等方式要点
创建订单客户端生成 request_id,服务端唯一索引重复请求返回首次结果,不报错
支付回调以支付单号 + 状态机判定只允许「未支付 → 已支付」迁移一次
消息消费消费记录表(消息 ID 唯一)消费失败可重试,重试不重复生效
定时任务分布式锁 + 任务执行记录多实例部署时必须加锁

判据:任何写接口,问一句「同一请求发两次会怎样」,答不上来就是隐患。


四、缓存:三个问题与三条策略

问题现象解法
穿透查不存在的数据,全部打到数据库缓存空值(短 TTL)+ 参数校验
击穿热点 key 过期瞬间大量请求打库逻辑过期 / 互斥重建(只放一个请求回源)
雪崩大量 key 同时过期TTL 加随机抖动 + 多级缓存
策略顺序适用
Cache-Aside读:先缓存后库;写:先更新库再删缓存绝大多数业务
Write-Through写时同时更新缓存与库缓存与库强一致要求高
Write-Behind先写缓存,异步落库写入量大、可容忍短暂丢失

核心规律:缓存是「可丢失的加速层」。凡是不能丢的数据,缓存只做读加速,不做唯一存储。


五、异步与队列:把「必须现在做」变成「可以稍后做」

该异步不该异步
发短信/邮件、生成报表、图片处理、跨系统同步扣款、扣库存等需要即时结果的核心写
要点做法
可靠投递业务数据与消息同事务写入 outbox 表,再由投递器发送
幂等消费消费前查消息 ID,处理成功才标记
重试指数退避 + 最大次数,超限进死信队列并告警
积压监控队列长度与消费延迟,超阈值扩容消费者
顺序需要顺序时按业务键分区,不要依赖全局顺序

六、接口防护:四道闸门

闸门做什么关键点
认证你是谁Token/Session 校验,令牌有有效期与刷新机制
授权你能做什么每个接口校验资源归属,不能只校验登录
限流你能来多快按用户/接口/IP 限流,超限返回 429
降级坏了怎么办非核心功能可关闭,返回兜底数据而非报错

越权是最高频的安全漏洞:GET /orders/123 必须校验 123 是否属于当前用户,而不是只校验已登录。


七、Laravel 落地要点

flowchart LR
    A["接口绑定"] --> B["容器解析"]
    B --> C["构造函数注入"]
    C --> D["可替换、可测试"]
// 依赖注入:面向接口,便于替换与测试
$app->bind(OrderRepository::class, EloquentOrderRepository::class);
 
// 薄控制器:只做校验与编排
class OrderController {
    public function store(CreateOrderRequest $request, OrderService $service) {
        return response()->json($service->create($request->validated()), 201);
    }
}
 
// 避免 N+1:预加载 + 分块处理
$orders = Order::with('items.product')->paginate(20);
Order::where('status', 'paid')->chunkById(500, fn ($rows) => /* ... */);
反模式症状改法
贫血模型实体只有属性,规则全在 Service把状态迁移与不变量放回实体
God Controller一个方法几十行,验证+业务+通知拆 Request 校验 + Service + 事件
N+1 查询列表页 SQL 数量随行数增长with() 预加载,检查查询日志
大事务事务里发消息、调外部接口缩小事务范围,副作用移出
魔法数字代码里散落 0/1/2 状态值用枚举与常量,配合状态机校验

八、可测试性:后端设计的隐形验收标准

特征说明
无隐藏依赖依赖通过构造函数传入,不在方法内 new
时间可控用注入的时钟替代 now(),便于测试边界
副作用可观测发消息、写文件通过接口,测试可替换
用例可独立运行不依赖执行顺序与共享全局状态

🎓 实战场景(TIL)

  • 场景:一个依赖服务变慢,自己的服务也跟着堆满线程。本质:超时比调用方长、没并发上限,故障沿调用链放大。要点:超时逐层递减,每个外部依赖单独连接池 + 熔断,失败快速返回而不是排队。
  • 场景:缓存集中失效(雪崩)瞬间数据库 CPU 100%。本质:热 key 同一时刻过期,大量请求直接落库。要点:过期时间加随机抖动,热点 key 用互斥重建或常驻更新,并保留降级读旧值。
  • 场景:重试造成重复扣款。本质:重试与并发下,接口不幂等。要点:以业务单号做唯一约束 + 状态机守卫,先查后写,写操作返回上一次结果而非重复执行。
  • 场景:后台一个报表查询把线上主库拖垮。本质:分析型 SQL 与交易共用资源。要点:读写分离或走副本,限制单次扫描行数,长查询加超时与分页,禁止无索引字段过滤。

📋 一页速查

我要做照着做
放业务规则规则进实体/领域服务;Controller 只校验与编排
开事务只包数据库写;RPC、消息、日志全部移出
写接口幂等建业务唯一键 + 唯一索引;重复请求返回首次结果
用缓存读多写少才缓存;先更新库再删缓存;空值也缓存
决定异步非即时必需 → 队列;核心扣减 → 同步
防越权每个资源操作校验归属,不只校验登录态
看性能查 SQL 数量(防 N+1)与慢查询日志,而非凭感觉
判断分层好坏换掉数据库/框架,领域层不用改 → 分层成立

🔗 相关链接