30 KiB
A2 · 工作流 / 轮次 / 分支 / 交叉评审 状态机
审计范围(实际逐行通读的源文件):
backend/services/workflow_round_service.pybackend/services/workflow_service.pybackend/services/workflow_generation_cross_review_service.pybackend/services/generation_cross_review_service.pybackend/services/workflow_feedback_interpreter.pybackend/services/workflow_round_feedback_service.pybackend/services/branch_lineage_service.pybackend/services/workflow_round_worker_runtime.pybackend/services/generation_job_retry_service.py(前 120 行)backend/routes/round_routes.pydatabase/repositories/workflow_round_repository.pydatabase/repositories/workflow_cross_review_repository.pydatabase/models.py、database/migrations/0014_workflow_generation_rounds.sql、database/db_helper.py(connect 部分)frontend/standalone-web/src/App.vue(轮次相关片段:2336-2340、7030-7075)另:已用
python -c实际执行WorkflowFeedbackInterpreter/WorkflowRoundFeedbackService验证 F4、F5 两条发现。
摘要
轮次状态机的写入口分散且没有统一的状态守卫:WorkflowRoundRepository.update_round() 是一个裸 UPDATE,_ensure_writable_round_row() 的只读保护只在 apply_feedback_atomic / confirm_candidate_atomic 等少数事务里生效,而 _ensure_round_enqueued() 和 reconcile_round() 绕过它无条件改写 status。结果是 confirmed / superseded 这两个终态可以被普通的幂等重放或迟到的 worker 回调回退成 queued / completed,从而击穿"已定稿轮次只读"和"跨评审必须复用已确认候选"两条核心不变量。
分支层面,create_next_round 把父轮次标记 superseded 之后没有任何机制阻止父轮次继续被 reconcile 回写,也没有 next_round_id 唯一性守卫(交叉评审侧有 next_review_round_id,主轮次侧没有),同一父轮次可以分叉出多个"下一轮"并互相覆盖节点的 active_round_id。
反馈解释器方面,LLM 路径对扁平结构的模型输出会静默丢弃全部候选偏好(只保留 patch),确定性回退路径会把用户文本里的普通数字("不要 3 个人"、"分辨率 512")当作候选编号,导致误拒候选或直接 400。
性能上 list_node_rounds → _persisted_detail 是典型 N+1,且本仓库每次仓储调用都 sqlite3.connect() 新建连接,一次轮次列表加载可产生数十条独立连接,而前端还在轮询该接口。
发现
[P0-致命] update_round 无状态机守卫:已确认(confirmed)轮次可被幂等重放静默回退,击穿只读锁与跨评审校验
- 位置:
backend/services/workflow_round_service.py:115、backend/services/workflow_round_service.py:928、database/repositories/workflow_round_repository.py:416 - 问题:
create_round命中 idempotency_key 重放分支时,会无条件调用_ensure_round_enqueued(existing, ctx);该方法末尾又无条件把轮次status写成"queued",随后reconcile_round依据候选聚合把它改成completed。整条链路上没有任何一处检查existing.status是否已经是confirmed/superseded这类终态,而update_round本身只是一条裸 UPDATE,_ensure_writable_round_row()的只读保护完全没有参与。 - 代码:
# workflow_round_service.py:115-117 —— 幂等重放路径 if self.generation_service is not None: self._ensure_round_enqueued(existing, ctx) return {**self.get_round(existing.round_id).to_dict(), "created": False, "idempotent_replay": True}# workflow_round_service.py:928-940 —— 无条件覆写 status latest = self.round_repository.get_round(round_record.round_id) or round_record self.round_repository.update_round( round_record.round_id, { "status": "queued", "metadata": { **latest.metadata, "planned_only": False, "task_ids": task_ids, }, }, ) self.reconcile_round(round_record.round_id, ctx)
对照被绕过的守卫:# workflow_round_repository.py:416-431 —— 裸 UPDATE,不校验当前 status def update_round(self, round_id: str, payload: dict[str, Any]) -> WorkflowGenerationRound | None: assignments, params = _round_update_assignments(payload, self.placeholder) ... conn.execute( f"UPDATE workflow_generation_rounds SET {', '.join(assignments)} WHERE round_id = {self.placeholder}", tuple(params), )# workflow_round_repository.py:1364-1369 if status == "confirmed": raise WorkflowRoundWriteError( "round_already_confirmed", "confirmed workflow round is read-only", {"round_id": round_id}, ) - 影响:
客户端(或 AstrBot 聊天侧)用同一个
idempotency_key重试POST nodes/{id}/rounds(网络超时后的正常重试即可触发,不需要并发),一个已经confirmed的轮次会退回completed。后果链:_ensure_writable_round_row不再拦截 →apply_feedback_atomic可以继续改写已定稿轮次的候选偏好/_conversation;WorkflowCrossReviewRepository._load_source_owner(workflow_cross_review_repository.py:1066-1076)只在status == "confirmed"时校验confirmed_candidate_mismatch,状态被回退后该校验被跳过 → 用户可以对与已定稿候选不同的候选发起跨评审;同理_ensure_review_after_confirmation_is_safe(:1108-1111)在非 confirmed 时直接 return,下游节点已完成的保护也一并失效;record_skip_restoration_handoff_atomic(:795)要求status == 'confirmed',回退后跳过流程的 XF 交接会永久失败。 节点侧selected_image_id仍指向旧图,轮次侧却重新变成可写,两边彻底不一致。
- 修复建议:
- 在
WorkflowRoundRepository增加update_round_if_status(round_id, expected_statuses, payload)(仓库里已有同模式的update_workflow_if_status/update_node_if_status可参照),或在update_round内部对status赋值做终态白名单校验:confirmed/superseded/cancelled一律拒绝降级。 create_round的幂等重放分支加前置判断:if existing.status in {"confirmed", "superseded", "cancelled"}: return {**self.get_round(existing.round_id).to_dict(), "created": False, "idempotent_replay": True}_ensure_round_enqueued末尾改为"status": "queued" if task_ids else latest.status,并同样跳过终态轮次。
- 在
[P1-严重] reconcile_round 无条件回写状态与节点指针:迟到的候选回调会把 superseded 父轮次"复活"并把节点 active_round_id 指回旧轮次
- 位置:
backend/services/workflow_round_service.py:806、backend/services/workflow_round_service.py:621 - 问题:
create_next_round只要求父轮次里有 1~3 个 succeeded 的 liked 候选,并不要求父轮次已经终态(get_consistent_round_snapshot没有任何 status 校验)。因此完全可以在父轮次还有候选处于queued/running时创建子轮次,父轮次被打上superseded。当那些残留候选随后完成时,worker 的handle_task_terminal → reconcile_round(parent)会用聚合状态覆盖superseded,同时把节点 metadata 的active_round_id重新指向父轮次。 - 代码:
# workflow_round_service.py:818-847 updated_round = self.round_repository.update_round( round_id, { "status": round_status, # 直接覆盖 superseded / confirmed ... }, ) or round_record if self.generation_service is not None: ... if node.status not in {"selected", "discarded"}: update_payload = { "status": node_status, "metadata": { **metadata, "active_round_id": round_id, # 指回被 reconcile 的那个轮次 "last_round_status": round_status, ...
且# workflow_round_service.py:621-633 —— 父轮次被标 superseded,但没有任何后续保护 superseded_parent = self.round_repository.update_round( parent_round_id, {"status": "superseded", "metadata": {..., "superseded_by_round_id": created.get("round_id"), ...}}, )_ensure_writable_round_row(workflow_round_repository.py:1355-1375)的不可写列表里没有superseded:if status in {"cancelled", "all_failed"}: raise WorkflowRoundWriteError("round_not_writable", ...) - 影响:
- 父轮次状态从
superseded变回completed/partial_success,UI 上同一节点出现两个"可确认"的轮次,用户可能在旧轮次上定稿,绕过刚创建的优化子轮次; - 节点
metadata.active_round_id被改回父轮次,前端App.vue:2336的selectedWorkflowActiveRoundId直接采信该值(不做"是否在已加载轮次列表中"的校验,和App.vue:7048的加载逻辑不一致),面板会跳回旧轮次; - 节点
status由父轮次聚合结果决定,子轮次还在跑时节点就被标completed; superseded轮次仍可写反馈 → 用户能对已被取代的轮次继续 like/reject,且可以再次create_next_round生成第二个子轮次(主轮次侧缺少交叉评审那样的next_review_round_id唯一性守卫,见下一条)。
- 父轮次状态从
- 修复建议:
_reconcile_round_locked读取round_record.status,若已是confirmed/superseded/cancelled,只更新metadata.execution_summary,不写status,也不改节点的active_round_id;- 更新节点前先确认
round_id == node.metadata.get("active_round_id")或该轮次仍是该节点最新的非终态轮次,避免旧轮次抢占节点指针; - 把
superseded加入_ensure_writable_round_row的不可写状态集合。
[P2-中等] create_next_round 缺少"一个父轮次只能有一个子轮次"的守卫,可分叉出多条优化链
- 位置:
backend/services/workflow_round_service.py:465(create_next_round全流程) - 问题:交叉评审侧有明确守卫:
而主轮次的# workflow_cross_review_repository.py:171-182 existing_child = _optional_text(parent_metadata.get("next_review_round_id")) if existing_child: raise WorkflowRoundWriteError( "cross_review_followup_exists", "this review round already has a follow-up", {..., "required_action": "open_latest_cross_review"}, )create_next_round只写superseded_by_round_id,创建前不检查它是否已存在:
唯一的并发保护是# workflow_round_service.py:620-633 created = self.create_round(parent.node_id, next_payload, ctx) superseded_parent = self.round_repository.update_round( parent_round_id, {"status": "superseded", "metadata": {**parent.metadata, "superseded_by_round_id": created.get("round_id"), ...}}, )parent_feedback_revision乐观校验(workflow_round_repository.py:162-174),但它只在父轮次 feedback 发生变化时才拒绝;两次内容相同的create_next_round请求(不带 idempotency_key,或带不同 key)revision 一致,两次都会成功。 - 影响:同一父轮次产生两个平级子轮次,
superseded_by_round_id被后者覆盖,前者成为无人引用的孤儿优化链;节点的active_round_id在两条链之间来回跳;_feedback_summary/feedback_context.parent_round_id追溯信息失真。 - 修复建议:把
superseded_by_round_id的存在性检查移进create_round_with_candidates的同一事务(该事务已经对 parent 行加了FOR UPDATE/BEGIN IMMEDIATE),存在即抛next_round_exists;或在workflow_generation_rounds(parent_round_id, round_kind)上加部分唯一索引。
[P2-中等] LLM 返回扁平结构时,候选偏好被静默丢弃(不报错、不回退到确定性解析)
- 位置:
backend/services/workflow_round_feedback_service.py:166(_normalize_model_payload) - 问题:
_model_request下发的response_schema把 liked/rejected/... 嵌在feedback下,_normalize_model_payload也只从parsed["feedback"]取这些键;模型若按常见习惯返回扁平结构(顶层直接给liked),feedback为空 dict,候选偏好全部丢失,但positive_patch因为单独从顶层取而被保留,于是校验通过、source="llm_validated"、fallback_used=False——没有任何错误、也不会回退到确定性解析器。 - 代码:
实测(本机执行):# workflow_round_feedback_service.py:178-189 feedback = parsed.get("feedback") feedback = dict(feedback) if isinstance(feedback, Mapping) else {} merged = { **feedback, # 顶层的 liked/rejected/final 在这里被丢掉 "positive_patch": parsed.get("positive_patch", feedback.get("positive_patch", parsed.get("next_round_prompt_patch"))), "negative_patch": parsed.get("negative_patch", feedback.get("negative_patch")), "material_intent": parsed.get("material_intent", feedback.get("material_intent")), } return mergedflat payload {'liked': ['TX-01-02'], 'positive_patch': 'more light'} -> source=llm_validated liked=[] patch='more light' fallback_used=False nested payload {'feedback': {'liked': ['TX-01-02']}, 'positive_patch': 'more light'} -> source=llm_validated liked=['TX-01-02'] - 影响:用户说"保留第 2 张并加点光",系统只记下 patch、丢掉"保留第 2 张"。随后
create_next_round因为liked为空直接 400(workflow_round_service.py:504-514"select one to three liked candidates"),用户看不到任何"模型没理解"的提示,只会认为功能坏了;更糟的情况是同一请求里还有rejected,则用户的拒绝意图被无声吞掉。 - 修复建议:
_normalize_model_payload对四个动作字段做feedback.get(k, parsed.get(k))的双层回退;并在merged中所有动作字段都为空且parsed顶层存在同名键时,抛WorkflowFeedbackInterpretationError("invalid_llm_result", ...),让interpret()的except Exception走确定性回退,而不是"半成功"。
[P2-中等] 确定性反馈解析器把普通数字当候选编号:静默误拒候选 / 合法反馈被 400
- 位置:
backend/services/workflow_feedback_interpreter.py:46(_DISPLAY_CODE_OR_NUMBER_RE)、:172-208(interpret主循环) - 问题:候选 token 正则里包含裸
\d{1,3},任何 1~3 位数字都会被当成候选序号;interpret又会把"没有动作词但有数字"的后续片段挂到上一个动作(active_prefix_action)。这是LLM 不可用时的默认路径(round_routes.py:143-150:未配置prompt_planning路由时feedback_callable=None)。 - 代码:
实测(白名单# workflow_feedback_interpreter.py:46-54 _DISPLAY_CODE_OR_NUMBER_RE = re.compile( r"(?<![A-Za-z0-9])" r"(?:" r"(?=[A-Za-z0-9-]*\d)[A-Za-z][A-Za-z0-9]*(?:-[A-Za-z0-9]+)+" r"|\d{1,3}" # ← 任意 1~3 位数字 r")" r"(?![A-Za-z0-9])", re.IGNORECASE, )TX-01-01..TX-01-04):"喜欢 TX-01-01,不要 3 个人" -> liked=['TX-01-01'] rejected=['TX-01-03'] # 静默误拒 "拒绝 02,分辨率 512" -> WorkflowFeedbackInterpretationError: reason=unknown_candidate_reference, reference='512' - 影响:
- 误拒路径:
update_feedback会把 TX-01-03 写成rejected并落pool_state='rejected'+ history,用户完全不知情,且该候选此后无法confirm(confirm_candidate_atomic拒绝 rejected 候选); - 400 路径:只要用户反馈里出现 3 位以内数字(尺寸、人数、年龄、角度…),整个反馈请求被
ApiError(VALIDATION_FAILED, "candidate reference '512' is not in the current whitelist")拒绝,错误信息对用户毫无意义。
- 误拒路径:
- 修复建议:
- 裸数字只在紧邻候选语境时才视为候选引用——要求前置量词/标记(
候选、第、#、No.、张、号);把无标记的\d{1,3}从_DISPLAY_CODE_OR_NUMBER_RE移除,交给_CHINESE_ORDINAL_RE这类带标记的规则; - 解析出的数字若不在白名单的终端序号集合内,应当忽略而不是抛
unknown_candidate_reference(仅当该 token 带显式候选标记时才报错); active_prefix_action跨片段续接时同样只接受带标记的 token。
- 裸数字只在紧邻候选语境时才视为候选引用——要求前置量词/标记(
[P2-中等] list_node_rounds 的 N+1,且每次仓储调用都新建一条 SQLite 连接
- 位置:
backend/services/workflow_round_service.py:982(_persisted_detail)、backend/services/workflow_round_service.py:942(list_node_rounds)、database/db_helper.py:159(connect) - 问题:
list_node_rounds对该节点的每一个轮次调用_persisted_detail,后者对每一个候选再各查一次 image 和 task;而所有仓储方法都是conn = self.database.connect() … conn.close(),即每次查询都新建一条sqlite3.connect()(还要跑两条 PRAGMA)。 - 代码:
# workflow_round_service.py:982-998 def _persisted_detail(self, round_record: WorkflowGenerationRound) -> WorkflowGenerationRoundDetail: candidates = {item.candidate_id: item for item in self.round_repository.list_candidates(round_record.round_id)} views: list[WorkflowRoundCandidateView] = [] for pool in self.round_repository.list_pool(round_record.round_id): candidate = candidates.get(pool.candidate_id) or self.round_repository.get_candidate(pool.candidate_id) if candidate is None: continue image = self.image_repository.get(candidate.image_id) if candidate.image_id else None task = self.job_repository.get(candidate.current_task_id) if candidate.current_task_id else None# db_helper.py:159-170 def connect(self): if self.backend == "sqlite": ... conn = sqlite3.connect(db_path, timeout=30.0) conn.row_factory = sqlite3.Row conn.execute("PRAGMA foreign_keys = ON") conn.execute("PRAGMA busy_timeout = 30000") return conn - 影响:一个有 6 轮 × 4 候选的节点,单次
GET nodes/{id}/rounds约产生3 + 6×(2 + 4×2) ≈ 63条独立连接/查询;而前端App.vue的scheduleWorkflowRoundPolling在轮次运行期间会周期性重拉该接口。SQLite 单写锁下,这会与 worker 的候选写入争抢busy_timeout,放大database is locked风险。 - 修复建议:
- 给
WorkflowRoundRepository增加批量方法list_candidates_for_rounds(round_ids)/list_pool_for_rounds(round_ids)(WHERE origin_round_id IN (...)),一次取回全部轮次的候选与池; ImageRepository/JobRepository增加get_many(ids);_persisted_detail改为接收预取好的字典;- 中期考虑给
Database加连接复用(线程本地连接或连接池),当前"每查询一连接"在轮询场景下代价过高。
- 给
[P2-中等] 交叉评审的幂等重放只按 idempotency_key 全表匹配,可命中另一个节点/另一种轮次并对其改状态
- 位置:
database/repositories/workflow_cross_review_repository.py:969(_round_replay)、被:57与:166调用 - 问题:
idempotency_key在workflow_generation_rounds上是全表唯一(0014_workflow_generation_rounds.sql:idx_workflow_rounds_idempotency),主轮次、交叉评审轮次、XF 交接轮次共用同一个键空间。但_round_replay只按 key 查,不校验命中的轮次是否属于本次请求的 source round / node / round_kind: - 代码:
对照主轮次侧有这层校验(# workflow_cross_review_repository.py:969-978 def _round_replay(self, conn: Any, idempotency_key: str | None) -> dict[str, Any] | None: if not idempotency_key: return None row = conn.execute( f"SELECT round_id, display_code FROM workflow_generation_rounds WHERE idempotency_key = {self.placeholder}", (idempotency_key,), ).fetchone() if row is None: return None return {"round_id": row["round_id"], "display_code": row["display_code"]}workflow_round_service.py:94-114:existing.node_id != node.node_id/existing.parent_round_id均会报错)。 且返回后调用方立刻对这个"重放命中"的轮次做写操作:
而# workflow_generation_cross_review_service.py:389-391 self._ensure_enqueued(str(created["round_id"]), ctx) result = {**self.round_service.get_round(str(created["round_id"]), ctx).to_dict(), "review_operation": created}_ensure_enqueued(:668-676)末尾会update_round(status=..., metadata={... "task_ids": ..., "planned_only": False})并reconcile_round。 - 影响:客户端在不同操作上复用同一个
idempotency_key(UI 用同一个"操作 id"、或聊天侧用消息 id 做 key 都会踩到),交叉评审请求会"成功"返回一个完全无关的轮次,并把它的status/metadata.task_ids覆盖掉、触发一次针对该轮次的 reconcile(进而改写其节点的active_round_id)。跨用户场景下round_service.get_round(..., ctx)的require_node会在最后一步拦住读取,但写入已经发生。 - 修复建议:
_round_replay增加参数并校验:命中行的round_kind必须匹配、node_id/workflow_id必须等于round_payload中的值、parent_round_id必须等于本次的 source/parent;不匹配时抛WorkflowRoundWriteError("idempotency_key_conflict", ...)而不是当作重放。
[P2-中等] 跨评审 skip 由三段独立事务组成,中途失败会留下"已跳过但未定稿"的不一致状态
- 位置:
backend/services/workflow_generation_cross_review_service.py:407(_skip) - 问题:跳过流程依次执行三个各自独立提交的事务:①
record_skip_atomic(写generation_cross_review.decision='skip'+ history)→ ②round_service.confirm_candidate(另一个连接里的confirm_candidate_atomic)→ ③record_skip_restoration_handoff_atomic(要求status == 'confirmed')。 - 代码:
② 的失败原因很现实:# workflow_generation_cross_review_service.py:416-445 try: decision = self.cross_review_repository.record_skip_atomic(...) # ① 已提交 except WorkflowRoundWriteError as exc: raise _write_error(exc) from exc if decision.get("already_confirmed"): result = self.round_service.get_round(source_round_id, ctx).to_dict() else: result = self.round_service.confirm_candidate( # ② 可能抛错 source_round_id, {"candidate_id": candidate_id, "idempotency_key": f"{idempotency_key}:confirm" if idempotency_key else None}, ctx, ) try: restoration_handoff = ( self.cross_review_repository.record_skip_restoration_handoff_atomic(...) # ③ 要求 confirmed )confirm_candidate_atomic会因round_branch_not_active(另一个标签页切了分支)、node_already_completed、candidate_image_restricted而抛错。 - 影响:轮次 metadata 里已经写死
decision='skip',但轮次并未 confirmed、XF 输入库也没有条目。此时用户如果改主意想走review,会被record_skip_atomic的分支挡住吗?——不会,existing.get("decision") == "skip"分支会当成幂等重放返回already_confirmed=False,然后又去confirm_candidate,永远卡在同一个失败点;而走review分支的create_review_round_atomic不检查decision=='skip',会在一个已标记跳过的轮次上再建评审轮次,两个状态并存。 - 修复建议:
- 把"记录 skip + 确认候选"合并为一个事务(
record_skip_atomic内部直接完成 confirm 所需的全部写入,或让confirm_candidate_atomic接受一个review_decision参数在同一 conn 内落库); - 若暂时无法合并,则在
record_skip_atomic里区分"已记录但未确认"的中间态(如decision_state='pending_confirm'),并允许用户显式撤销该跳过决定; create_review_round_atomic增加decision == 'skip'的互斥校验。
- 把"记录 skip + 确认候选"合并为一个事务(
[P2-中等] apply_feedback_atomic 会把旧的 _conversation 无条件带到新快照,导致 create_next_round 复用过期的 prompt patch
- 位置:
database/repositories/workflow_round_repository.py:703、backend/services/workflow_round_service.py:534 - 问题:每次反馈写入都会用池里的最新偏好重建
feedback_snapshot,然后把上一版快照里所有_前缀的键原样复制回来。当用户第一次用自然语言反馈(写入_conversation),第二次改用结构化updates(此时conversation is None,不覆盖),旧的_conversation会被保留。 - 代码:
# workflow_round_repository.py:703-716 feedback_snapshot = { str(row["candidate_id"]): {...} for row in pool_rows } for key, value in previous_snapshot.items(): if str(key).startswith("_"): feedback_snapshot[str(key)] = value # ← 旧 _conversation 原样带过来 ... if conversation is not None: feedback_snapshot["_conversation"] = conversation# workflow_round_service.py:534-559 —— create_next_round 直接吃这个残留值 conversation = parent.feedback_snapshot.get("_conversation") conversation = dict(conversation) if isinstance(conversation, dict) else {} ... positive_patch = _bounded_optional_text(conversation.get("positive_patch"), field="positive_patch", maximum=4_000) material_intent = _bounded_optional_text(conversation.get("material_intent"), ...) - 影响:用户第一轮说"下一轮加暖光",之后改口用界面按钮重新勾选偏好(不再提暖光),生成的子轮次仍会带上"加暖光"的
prompt_patch与material_intent,且feedback_context.source_text显示的是那句早已作废的原话。用户无法通过 UI 清除该 patch。 - 修复建议:在
_conversation里记录写入序号/时间戳与其所依据的pool_revision;create_next_round只在_conversation对应的是最近一次反馈写入时才采用其 patch,否则只使用池偏好 +_strict_rejection_patch。或者更简单:结构化updates写入时显式feedback_snapshot.pop("_conversation", None),并在 API 上暴露"清除对话补丁"的能力。
[P3-轻微] 反馈幂等日志按字典序而非时间序裁剪,会淘汰掉较新的 key
- 位置:
database/repositories/workflow_round_repository.py:719 - 问题:
request_log是从metadata_json反序列化出来的 dict,而写库时用的是json.dumps(..., sort_keys=True)(workflow_round_repository.py:1318-1321),所以重新读出来的插入顺序是字典序,不是写入时间顺序。[-20:]因此保留的是"字典序最大的 20 个 key"。 - 代码:
# workflow_round_repository.py:719-726 if idempotency_key: request_log[idempotency_key] = {...} request_log = dict(list(request_log.items())[-20:])# workflow_round_repository.py:1318-1321 def _json_or_none(value: Any | None) -> str | None: if value is None: return None return json.dumps(value, ensure_ascii=False, sort_keys=True) - 影响:在同一轮次上做超过 20 次带 key 的反馈写入后,被淘汰的是字典序小的 key(例如以
a开头的 UUID),而非最旧的。用户对一个刚提交过的请求做重试时,幂等记录可能已被淘汰 → 重复写入一条round_feedback_updatedhistory,并重复触发审计事件。 - 修复建议:在每条记录里已有
updated_at字段,裁剪时按它排序:request_log = dict(sorted(request_log.items(), key=lambda kv: str(kv[1].get("updated_at") or ""))[-20:])
[P3-轻微] approve 响应里对同一个 next_node_id 重复查询节点
- 位置:
backend/services/workflow_generation_cross_review_service.py:259 - 问题:条件表达式里把
get_node调了两次(一次判空、一次取值),既是多余的 DB 往返,也有 TOCTOU(两次之间节点被删则第二次返回None,.to_dict()抛AttributeError)。 - 代码:
# workflow_generation_cross_review_service.py:259-267 return { **self.round_service.get_round(round_id, ctx).to_dict(), "approval": approval, "next_node": ( self.workflow_repository.get_node(str(approval["next_node_id"])).to_dict() if approval.get("next_node_id") and self.workflow_repository.get_node(str(approval["next_node_id"])) else None ), } - 影响:多一次数据库连接;极端竞态下 500 而非正常响应。
- 修复建议:
next_node = ( self.workflow_repository.get_node(str(approval["next_node_id"])) if approval.get("next_node_id") else None ) ... "next_node": next_node.to_dict() if next_node else None,