---
id: ka-guidance-专项实现
kind: guidance
title: 专项实现
sync_policy: engine_only
status: active
triggers:
  - 数据库迁移
  - 接口集成
  - 性能优化
  - 性能分析
  - 异步
  - 缓存
  - 定时任务
  - 文件上传
extra:
  name: specialized-implementation
  scope:
    - '*'
  products:
    - '*'
  category: procedure
  version: 1.0.0
  last_reviewed: '2026-06-17'
  verification_layer: L2
  stage: build
  domain: build
  owner_mechanism: mc-backend-pattern
---

# 专项实现：特定场景怎么做

> 吸收旧的「数据库迁移」「接口集成流水线」「性能分析」「性能流水线」「缓存策略」「异步导出」等。
> 按需注入，不强制全套。

## 数据库迁移

- 每个 migration 都有与数据风险匹配的恢复策略：安全可逆时使用 down；不可逆或会丢数据时采用 expand/contract、备份恢复或前向修复
- 大表变更评估锁表影响，分批/在线 DDL
- 数据迁移新老比对，回滚后一致性验证
- 详见 [[兼容性与迁移评估]]

## 接口集成

- 接口契约先行（OpenAPI），契约评审后再实现
- 字段映射精确到 表.字段
- 对接外部系统考虑超时/重试/幂等/签名
- 异常路径明确（对方不可用怎么办）

## 性能优化

- 先测量后优化（性能分析数据为证据，不靠猜）
- 优化目标使用项目 SLO、已确认基线或容量目标，不复制通用阈值
- 关注 N+1 查询、大循环、不必要序列化
- 缓存考虑一致性/失效/穿透/雪崩

## 异步与定时

- 异步任务幂等（可重试不重复执行）
- 定时任务考虑并发执行/分布式锁
- 长任务可中断、可观测进度

## 文件上传/导出

- 限制类型/大小，校验内容（防恶意文件）
- 大文件流式处理/分片，不一次性进内存
- 导出异步化，提供进度查询

## 禁止

- 迁移没有可验证的安全恢复路径（违规）
- 接口集成不定义契约（违规）
- 性能优化无测量证据（违规，[[证据驱动与反幻觉]]）
- 异步任务不幂等（违规）