# known-issues P6 补丁

> 本文件为 `docs/troubleshooting/known-issues.md` 的 P6 阶段补丁，列出 P6 新增的"场景→技术"映射。
> 合并方式：将下表条目追加到原文件对应分区，遵循索引式速查规范，不写代码示例。

## P6 生产硬化新增场景

| 场景 | 技术方案 |
|------|----------|
| 熔断器状态切换（Closed/Open/Half-Open） | gobreaker v2 ReadyToTrip 回调按连续失败数 + 失败率判定 |
| 限流桶按租户维度清理 | sync.Map + ticker 周期清理过期桶，避免内存泄漏 |
| 备份脚本定时调度 | K8s CronJob + backup-cron.sh，15min 一次满足 RPO |
| PostgreSQL WAL 归档恢复到时间点 | pg_receivewal 归档 + PITR 恢复 |
| Redis 增量备份 | BGSAVE 触发 + RDB 文件上传对象存储 |
| Kafka 消费位点快照 | __consumer_offsets topic dump 到对象存储 |
| 熔断器半开态试探限流 | MaxRequests 限制并发试探，避免恢复期二次过载 |
| 健康探针分流 liveness/readiness | /healthz 仅进程存活，/readyz 检查依赖，避免滚动重启雪崩 |
| 优雅停机等待 in-flight 请求 | app.enableShutdownHooks + terminationGracePeriodSeconds=60 |
| Kafka producer 关闭前 flush | producer.disconnect() 内部 flush，避免消息丢失 |
| 数据源销毁顺序 | 先 Kafka、再 Redis、最后 DB，避免反向依赖阻塞 |
| 混沌实验回滚 | rollback.sh 按实验名清理 tc/iptables 规则 |
| DNS 切换消除缓存 | TTL=60s + 等待 + 客户端清缓存，避免切换无效 |
| 告警抑制去重 | Alertmanager inhibit + group_by + group_wait |
| Python 服务就绪检查延迟初始化 | readyz 返回 ok + TODO，避免启动期依赖未就绪导致探针失败 |
