2026-09-21 11:13:14 +08:00
|
|
|
|
# 已知风险 — known-risks.md
|
|
|
|
|
|
|
2026-09-22 00:46:10 +08:00
|
|
|
|
> **版本**：V1.0.1 配置与规则纠偏基线 · **生效**：2026-09-21 · **最后更新**：2026-09-22 · **owner**：WorkBuddy
|
2026-09-21 11:13:14 +08:00
|
|
|
|
> 登记「已知但本轮不处置」的风险与债务。每项注明触发条件、影响面、处置去向。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
| # | 风险 / 债务 | 影响面 | 处置去向 |
|
|
|
|
|
|
|---|------------|--------|----------|
|
2026-09-22 00:46:10 +08:00
|
|
|
|
| KR-01 | **minio pin tag 拉取失败（2026-09-22 复测：仍未解决）**：`minio/minio:RELEASE.2025-09-07T16-13-09Z` 在本机从 Docker Hub 与 5 个国内镜像源（daocloud / 1panel / rat.dev / nju / sjtug / 1ms.run）**全部取不到该 tag**。本机 E2E 以「把本地 `quay.io/minio/minio:latest` 重打为钉版 tag」绕过 —— ⚠️ **这是对钉版基线的偏离**，仅限本地测试环境（机构接口验收不依赖对象存储）；CI（ubuntu runner）可达 Docker Hub，不受影响。 | 本机 E2E 全栈序列；生产部署镜像拉取 | 换 pin 版本或走可拉取的镜像源；上 CI 后实测。生产 compose 未改。 |
|
2026-09-21 11:13:14 +08:00
|
|
|
|
| KR-02 | **`system_configs` 死表**：V001 建表 + seed（match_rule_version/daily_recommendation_limit/match_score_threshold='60'/recommendation_cooldown_days）+ demo-seed 一批 flag 行，**0 个 Java 读取点**；与活键 `match.*` / `features.*` 各写一份（seed 与代码漂移） | 配置可信源混淆（运维改 system_configs 不生效） | 未来迁移裁定：整体退役（DROP 需专门迁移）或接成真实配置源。见 config-drift-audit §一。 |
|
|
|
|
|
|
| KR-03 | **`match_rule_configs` 死表**（V006，含 10 维权重 + minimum_score）+ `MatchRuleConfigMapper.findActive/findByVersion` 无调用方 | 规则版本化走轻量路线（rule_version + V050 threshold_snapshot），此表闲置 | 未来项：接成「规则版本唯一读取源」或删表。见 config-drift-audit §二。 |
|
|
|
|
|
|
| KR-04 | **打分占位未产品化**：`calculateScore` 恒 50.0、互选公式 0.6/0.4、level 分档 80/60 均硬编码（V1 占位） | 推荐分数无业务含义，不得对外包装「匹配成功率」 | 正式化时随 10 维权重一起配置化 + 记入规则版本（open-questions OQ-MATCH-001 关联项）。 |
|
|
|
|
|
|
| KR-05 | **本地资格佐证到期清理作业未实现**：`features.localEvidenceRetentionDays=365` 仅配置，无 @Scheduled 清理任务（文件本体交对象存储生命周期规则兜底） | 佐证文件可能超期留存 | Phase 22 运维任务（Phase-04 报告 :46 登记）。 |
|
2026-09-22 00:46:10 +08:00
|
|
|
|
| KR-06 | **GitHub Actions 实测未跑**：E2E 65/65 与回归 757 / 0 / 0 / 3 均为本机实测（2026-09-22 复跑）；CI 流水线仍未推过一次绿 | 「CI 绿」仍依赖一次推送。注意本机与 runner 的差异：**E2E 作业的 docker CLI 必须在 PATH 上** —— 本机实测该点会让 16 个依赖 `docker exec` 取库内 fixture 的用例报 `FileNotFoundError`（不是产品缺陷） | 批 3 遗留项（Phase 24 启动前）；一次 push 触发。 |
|
|
|
|
|
|
| KR-07 | ~~**本机 WSL/Docker 环境故障（2026-09-21）**~~ → **2026-09-22 已解除**：Docker Desktop 由用户启动后引擎正常（Server 29.8.0 / linux / 16 CPU / 8GB；CLI 位于 `D:\Data\Docker\DockerDesktop\resources\bin\docker.exe`，**不在 PATH**）。`wsl.exe` 仍被安全策略阻止（Program Blacklist，不可审批绕过），但本机容器路径已不依赖 WSL。 | 原生 docker 路径可用；本机全栈部署与 E2E 65/65 均已实跑 | 无（已闭环）。后续在本机跑容器需用 CLI 绝对路径，或自行把该 bin 加入 PATH。 |
|
|
|
|
|
|
| KR-08 | **Docker Hub 域名 DNS 被投毒（本机网络，2026-09-22 实测）**：`registry-1.docker.io` → `31.13.95.37`（Facebook 段）、`auth.docker.io` → `162.125.32.15`（Dropbox 段），**均为伪 IP** → `docker pull` 一律超时。宿主机对这两个域名的直连探测有正常响应（401/405），说明是**解析层**被污染而非出口被封；Maven Central 与 apk 源均正常可达。 | 本机所有需要拉取 Docker Hub 镜像的构建（temurin / node / nginx / postgres / redis / minio） | 绕行：从 `docker.m.daocloud.io` 等国内镜像源拉取后 retag 成本地名（本轮已实测可行）；Maven 侧改用阿里云源（实测 5337 vs 685 KB/s）。**未改 daemon DNS**，避免影响用户其他网络行为。 |
|
|
|
|
|
|
| KR-09 | **compose 项目名撞名（本机，2026-09-22 实测已造成实际破坏）**：本机另一项目 `AI智习室` 位于 `E:\develop\AI智习室\ai-study-room\infra`，**同样以 `-p infra` 为项目名**；其重新部署带 `--remove-orphans` 时，会把本项目以 `infra` 为项目名起的容器当作孤儿容器**删除**（本轮已实测发生：`danyang-match-postgres` / `-redis` 被清）。已确认邻项目 Postgres 卷未被重新初始化、**数据无丢失**。 | 本机多项目共用 `infra` 项目名时的容器互删 | 本项目本地栈统一改用 `docker compose -p danyang`；如需彻底隔离，各项目应使用互不相同的项目名。 |
|
2026-09-21 11:13:14 +08:00
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
2026-09-22 00:46:10 +08:00
|
|
|
|
*最后更新: 2026-09-22 — KR-07 解除（Docker 已恢复）；新增 KR-08（Docker Hub DNS 投毒）与 KR-09（compose 项目名撞名）；KR-01 / KR-06 按复测结果订正。*
|
