异步任务模式规范 当一个操作可能跑超过 10 秒 ，必须改成 + 的异步状态机模式。 不要让用户盯着一个会超时的 loading 转圈，更不要让他点第二下。 与 配合：先用后者把同步性能压到能跑完的范围；只有"再优化也压不到 10s 以内"时，才走本规范。 --- 触发条件 只要满足任一条件，就属于本 skill 的覆盖范围： - 单次操作处理数据量 ≥ 1000 条（批量导入、全表扫描、跨租户聚合） - 链路里有远程 API 批量调用，且 batch size × 单次延迟 5s - 历史上同步实现已经出过 504/502/30s timeout - 用户描述里出现"卡住"、"转圈很久"、"点完没反应" --- 陷阱 #1: 同步阻塞被网关切断 场景 : 6000 条商品查重，同步接口 30s 超时；前端无回执，用户重复点击。 错误示例 后果： - Nginx/网关默认 30-60s 截断 → 用户看到 502/504 - 用户重试 → 后端线程池被占满 → 雪崩 - 前端 loading 状态没法跨刷新保持 正确模板（Spring 版） --- 陷阱 #2: 状态缓存无界增长 → 内存泄漏 根因 ： 作为长生命周期缓存，每个进入过的租户都留下一条记录，FINISHED 后也不清理。 必须实现的清理策略 任选其一（推荐第 1 个，最简单）： | 策略 | 实现 | 适用 | |…