From c0a3b2bd972a227ca1e4a428ea821f339405d4a5 Mon Sep 17 00:00:00 2001 From: admin Date: Mon, 12 Oct 2026 12:27:55 +0800 Subject: [PATCH] =?UTF-8?q?fix(plan):=20sync/export=20=E5=BF=85=E9=A1=BB?= =?UTF-8?q?=E5=8F=91=E8=A3=B8=20SyncPayload=EF=BC=8C=E4=B8=8D=E8=83=BD?= =?UTF-8?q?=E8=B5=B0=E7=AE=A1=E7=90=86=E5=8F=B0=E4=BF=A1=E5=B0=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Task 3 的 h_sync_export 原本用 http::ok 包成 {code,data,msg},而 Task 2 的 pull_from_peer 是 from_str:: 直接解顶层 users/deleted——serde 忽略 未知的 code/data/msg,随后因缺 users 报错。pull 每次必然失败,且只有 Task 7 端到端才暴露:cargo check 干净,Task 2 该路径无测试,Task 3 单独看也对。 改为 http::send 发裸 JSON。同步链路自带 X-Sync-Token 鉴权,不该耦合管理台 信封格式——壳现在还在解析 data.plugins,信封是会变的。 顺带更正先前一处错误结论:ngx-rust 的 status.rs 定义了 5xx(500/502/503), 此前"无 5xx 常量"的判断是错的。plan 保留 INTERNAL_SERVER_ERROR,但理由换成 「pull 失败含载荷解析失败,不止网关转发失败」。 Co-Authored-By: Claude Code --- docs/superpowers/plans/2026-10-12-user-sync.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/superpowers/plans/2026-10-12-user-sync.md b/docs/superpowers/plans/2026-10-12-user-sync.md index d59401e..bb5204c 100644 --- a/docs/superpowers/plans/2026-10-12-user-sync.md +++ b/docs/superpowers/plans/2026-10-12-user-sync.md @@ -1069,15 +1069,24 @@ fn h_sync_push(r: *mut ngx_http_request_t, _actor: Actor) -> Status { } /// GET /api/admin/sync/export —— 导出本侧权威字段(供对端 pull)。 +/// GET /api/admin/sync/export —— 导出本侧权威字段全量快照。 +/// +/// ⚠️ **必须发裸 `SyncPayload`,不能用 `http::ok`**。`http::ok` 会包成 +/// `{code,data,msg}` 信封,而对端 `sync::pull_from_peer` 是 +/// `serde_json::from_str::` 直接解顶层 `users`/`deleted`—— +/// serde 忽略未知的 `code`/`data`/`msg`,随后因缺 `users` 字段报错, +/// **pull 每次都必然失败**(且只在 Task 7 端到端才暴露)。 +/// 同步链路是机器对机器、自带 token 鉴权,不该耦合管理台信封格式; +/// 信封形状是会变的(壳现在读 `data.plugins`)。 fn h_sync_export(r: *mut ngx_http_request_t, _actor: Actor) -> Status { let Some(side) = sync::local_authority() else { return http::fail(r, HTTPStatus::BAD_REQUEST, "本部署未配置 IPASS_SYNC_SIDE"); }; let payload = sync::authority_view(&store::read_users(), side); - http::ok(r, json!({ - "users": payload.users, - "deleted": payload.deleted, - }), "导出本侧权威字段") + match serde_json::to_string(&payload) { + Ok(body) => http::send(r, HTTPStatus::OK, &body), + Err(e) => http::fail(r, HTTPStatus::INTERNAL_SERVER_ERROR, &format!("序列化同步载荷失败:{e}")), + } } /// POST /api/admin/sync/pull —— 主动从对端拉全量并合并(补偿手段)。