chengma/cmroubao
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: T-275
Pages
00-ai-start-here 01-vision 02-requirements 03-tech-stack 04-architecture 05-coding-rules 06-tasks 07-user-stories 08-interaction-checklist Design Home Integrations-shunyunbao-contract PPT T-001 T-002 T-003 T-004 T-101 T-102 T-103 T-104 T-201 T-202 T-203 T-204 T-205 T-206 T-207 T-208 T-209 T-210 T-211 T-212 T-213 T-214 T-215 T-216 T-217 T-218 T-219 T-220 T-221 T-222 T-223 T-224 T-225 T-226 T-227 T-228 T-229 T-230 T-231 T-232 T-233 T-234 T-235 T-236 T-237 T-238 T-239 T-240 T-241 T-242 T-243 T-244 T-245 T-246 T-247 T-248 T-249 T-250 T-251 T-252 T-253 T-254 T-255 T-256 T-257 T-258 T-259 T-260 T-261 T-262 T-263 T-264 T-265 T-266 T-267 T-268 T-269 T-270 T-271 T-272 T-273 T-274 T-275 T-276 T-277 T-278 T-279 T-280 T-281 Task-Template Tasks agent-context api clean-state-checklist current-state routes
Clone
1
T-275
ila edited this page 2026-08-07 16:37:13 +08:00
Unescape Escape
Table of Contents
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

同步来源：docs/tasks/T-275.md · commit afc651f75a3a

id: T-275 title: 修复超长执行事件阻塞任务同步 phase: 2 deps:

  • T-207
  • T-274 status: DONE created: 2026-08-01 context_ref: f3f59fb work_branch: null write_paths:
  • docs/tasks/T-275.md
  • docs/current-state.md
  • docs/04-architecture.md
  • docs/05-coding-rules.md
  • android-buyer/app/src/main/**
  • android-buyer/app/src/test/**

问题 / 背景

安装 T-274 后，Roubao 任务模块持续提示“后台暂时离线，将在授权截止前重试”，但真机 日志证明手机已连接后台，上传 execution outbox 时收到不可重试的 HTTP 422 EXECUTION_RESULT_INVALID。候选搜索事件原长约 889 字节；T-274 追加六个 locator 诊断键后达到 1014 字节，超过后台单条事件 message 的 1000 字节契约。

当前同步循环还把所有非本地异常统一标记为离线，并将不可重试的 4xx 项永久保留在 outbox 队首，导致后续事件和 heartbeat 均无法执行。

行为契约

  1. 候选搜索的状态事件与聚合诊断事件分开发送；每条 message 的 UTF-8 长度必须在 后台 1000 字节上限内，核心状态、轮次、失败码和全部聚合计数均保留。
  2. T-274 已持久化但尚未被后台接受的超长候选事件，在上传前按稳定分隔点确定性拆成 两条合法事件；保持原事件 ID，派生诊断事件 ID 必须稳定，网络重试不能产生新事件。
  3. 迁移只处理可确认来源的 CANDIDATE_SEARCH/CANDIDATE_SEARCH_* 超长事件；其它 非法 payload 不得截断、丢弃或伪装成功。
  4. App 解析后台结构化错误中的非敏感字段校验详情。HTTP 已收到响应时后台状态保持在线； 仅连接、TLS、DNS、超时等 I/O 错误和可重试 5xx 显示后台暂时不可用。
  5. retryable=false 的 outbox 上传失败进入持久化阻塞状态，不再自动重试同一项，也不越过 该项继续 heartbeat 或自动化；UI 显示稳定错误码和安全字段，不显示响应正文、凭证、 商品信息或服务端内部信息。
  6. 更新后必须能自动修复当前手机里由 T-274 产生的 1014 字节候选事件并恢复队列同步， 不要求清除 App 数据、重新登录或丢弃任务。

方案

  1. 将候选尝试核心消息与 CandidateSearchDiagnostics 消息组装为同一 EVENTS payload 中 的两条事件，并增加共享 UTF-8 长度校验常量和单测。
  2. 在 outbox 上传边界增加窄范围 legacy payload 规范化器：识别单条超限候选事件，按 cards= 分隔，使用原 event ID 派生稳定 UUID 后形成两条事件。
  3. 扩展 ProcurementApiException 保存经过白名单裁剪的 details.fields；同步状态按是否 收到 HTTP 响应和 retryable 分类。
  4. 为 outbox 项增加可持久化 rejection 元数据。不可重试响应只记录一次并安全停止同步； legacy 修复在发请求前完成，因此当前已知超长项不会进入 rejection 状态。

验收要点

  • 新候选搜索状态和诊断事件分别小于等于 1000 UTF-8 字节，聚合字段完整。
  • T-274 的 1014 字节 legacy payload 被稳定拆分并成功上传，重复迁移结果相同。
  • HTTP 422 显示“后台拒绝执行结果”及安全字段，backendOnline=true，且不再重试。
  • I/O/超时和可重试 5xx 仍保留 outbox 并按既有授权边界重试。
  • 不可重试阻塞跨进程重启保持，不继续 heartbeat、拼多多动作或越过队首结果。
  • Android 单测、lint、Debug/Release APK 构建通过，Debug APK 覆盖安装到 PKG110。

边界

  • 不提高后台 1000 字节限制，不放宽敏感内容检查。
  • 不丢弃不可重试结果，不自动取消任务，不清除登录、claim、候选或下单状态。
  • 不修改三轮搜索、SKU/价格匹配、候选数量、VLM、支付边界或订单提交授权。

执行记录

  • 2026-08-01：根据真机 HTTP 422 日志和 T-274 消息长度复现创建任务，状态 TODO。 已确认网络、TLS 和 Bearer 鉴权不是本次错误；直接失败字段为 execution event message 超过 1000 UTF-8 字节。
  • 2026-08-01：候选状态和诊断改为同一 EVENTS payload 内两条有界事件；上传边界只对 T-274 单条超长候选格式执行确定性拆分，原 event ID 保留并稳定派生诊断 ID。App 只从 EXECUTION_RESULT_INVALID 的显式字段白名单读取字段名，不读取字段值或响应正文。 不可重试 outbox 拒绝会加密持久化错误码、HTTP 状态和字段名，停止同步、候选采集、 dry-run 和提交；I/O/可重试 5xx 仍保持原重试语义。
  • 2026-08-01：Debug/Release 各 462 项单测、lintDebug、assembleDebug、 assembleRelease 全部通过。Debug APK 以保留数据方式覆盖安装到 PKG110；安装后原持续 422 的任务恢复为等待后台确认商品。最终 APK 再覆盖安装并运行一个同步周期，logcat 未出现 EXECUTION_RESULT_INVALID、同步异常或崩溃，状态改为 DONE。