Skip to content

fix(app): 接單與建單的結果要向後端確認,不能只看有沒有丟例外 - #60

Closed
thothawei wants to merge 1 commit into
claude/app-lifecycle-resume-syncfrom
claude/accept-create-outcome-reconcile
Closed

thothawei wants to merge 1 commit into
claude/app-lifecycle-resume-syncfrom
claude/accept-create-outcome-reconcile

Conversation

@thothawei

Copy link
Copy Markdown
Owner

⚠️ 這是第三層 stacked PR:base 是 claude/app-lifecycle-resume-sync(#59),它的 base 又是 #58。合併順序 #58 → #59 → 本 PR,前一個合併後 GitHub 會自動把 base 往下推。

先取證,再說 bug

用 curl 打真後端量到的事實:

情境 後端實際回應 App 原本怎麼解讀
同一乘客第二次建單 409「已有進行中的訂單」 原樣顯示——但乘客畫面上根本沒有任何訂單,這句話無法行動
司機接一張已被別人接走的單 HTTP 200 +「手慢了,這單已被其他司機接走」 當成接單成功,樂觀行程卡留在畫面上
司機非待命狀態接單 HTTP 200 +「您目前無法接單(非待命狀態)」 同上

兩個真 bug

  1. 司機抱著一張別人的行程卡出發。acceptOffer 只在丟例外時才算失敗,而後端這兩種拒絕都是 200;舊碼的重讀 active 又寫著「回 null 或別的 rideId 時寧可保留樂觀設定」,於是沒接到也照樣顯示行程卡,直到司機按「乘客已上車」被 409 擋下才發現。
  2. 弱網下「請求送達、回應丟失」= 使用者被騙。
    • 司機端:接單其實成功了卻報錯 → 司機按「略過」→ 行程從畫面消失,而後端已把他設成載客中,他收不到新派單也無法離線(pitfall-driver-stuck-ontrip 的成因之一)。
    • 乘客端:建單其實成功了卻停在叫車表單,再按一次得到 409「已有進行中的訂單」——唯一出路是重開 App。

改了什麼

同一個原則:有副作用的請求,結果要向後端問,不能只看有沒有丟例外。

  • 司機端:接單後一律重讀 active,以「是不是這張單」判定三態。confirmed → 以後端資料覆蓋樂觀值(順帶補齊推播路徑缺的 stops);rejected → 收掉行程卡並說明「這單已被其他司機接走」;unknown(重讀本身也失敗)→ 保留樂觀行程,因為「真的接到卻看不到行程」更糟。逾時走同一條確認,確認到了就不報錯。後端 AcceptRide 是同步寫入後才回應,所以「回應之後 active 查得到」可以依賴——null 是真的沒接到。
  • 乘客端:建單逾時或 409 時先問後端有沒有進行中訂單,有就接手(含已被接單時的司機資訊)。400 之類的輸入錯誤不觸發對帳。成功與接手共用同一份狀態切換,避免兩份清單其中一份漏項而把上一趟的司機/取消通知帶進這一趟。

驗收

  • flutter analyze 無 issue、flutter test 257 passed(248 +新 7 +改寫 2)。改寫的是原本「回別的行程/null 時不覆蓋樂觀行程」那條——它釘的正是本輪要修掉的行為。
  • 反向確認:兩處修正各自拿掉後 5 案 FAIL。
  • 模擬器實跑:司機 A(simexp01)收到 ride feat: 乘客↔司機即時聊天與遺失物協尋 UI #8 接單卡 → 趁他還沒按,用 API 讓司機 B(simexp02)接走 → A 按「接單」→ 後端回 200「手慢了」→ App 沒有出現行程卡,改顯示紅色橫幅「這單已被其他司機接走」,回到「等待派單中」。DB 交叉驗證 ride feat: 乘客↔司機即時聊天與遺失物協尋 UI #8 driver_id = 6(司機 B)。
  • 誠實標記:「逾時但其實成功」在真機上不好精準重現(要讓回應剛好在 receiveTimeout 後才丟失),只有單元測試覆蓋,未在模擬器上實跑過。

已知未做

pickUp/completeRide/cancelRide 逾時後同樣可能「其實成功了」。本輪只修最貴的兩條,其餘等這套模式在真機上跑一陣子再推廣(已記在 TODO「下次任務」)。

🤖 Generated with Claude Code

對真後端取證發現兩件事:司機接一張已被別人接走的單,後端回的是
HTTP 200 +「手慢了,這單已被其他司機接走」(不是錯誤);乘客重複
建單則回 409「已有進行中的訂單」。

由此兩個真 bug:

1. 司機抱著一張別人的行程卡出發。acceptOffer 只在丟例外時才算失敗,
   而舊碼的重讀 active 又寫著「回 null 時寧可保留樂觀設定」,
   於是沒接到也照樣顯示行程卡,直到按「乘客已上車」被 409 擋下。
2. 弱網下「請求送達、回應丟失」= 使用者被騙。司機端接單其實成功卻報錯,
   他按「略過」後行程從畫面消失,而後端已把他設成載客中——收不到新派單
   也無法離線;乘客端建單其實成功卻停在叫車表單,再按一次得到
   「已有進行中的訂單」,唯一出路是重開 App。

修法(同一原則:有副作用的請求,結果要向後端問):
- 司機端接單後一律重讀 active,以「是不是這張單」判定三態——確認到就以
  後端資料覆蓋、確認沒接到就收掉行程卡並說明、連問都問不到才保留樂觀值。
  逾時走同一條確認,確認到了就不報錯。
- 乘客端建單逾時或 409 時先問後端有沒有進行中訂單,有就接手(含司機資訊);
  400 之類的輸入錯誤不觸發對帳。成功與接手共用同一份狀態切換。

驗收:flutter analyze 無 issue、flutter test 257 passed(新增 7、改寫 2);
反向確認兩處修正各自拿掉後 5 案 FAIL。
模擬器實跑:司機 A 收到 #8 接單卡 → 司機 B 用 API 搶走 → A 按接單 →
畫面不再出現行程卡,改顯示「這單已被其他司機接走」,DB driver_id=6 一致。
「逾時但其實成功」真機不好精準重現,只有單元測試覆蓋。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@thothawei

Copy link
Copy Markdown
Owner Author

以 #63(合併為 #65)+ #64 取代:司機端「接單以後端 active 為權威判成敗」在 #63,乘客端「建單逾時對帳」在 #64。

本 PR 獨有、已救回(#66):建單 409 也去對帳(#64 只對帳 statusCode == null,409 只顯示訊息=死路),以及接手時與建單成功共用 _applyCreatedRide(否則編輯中的多乘客清單與預估車資會留到下一趟)。

@thothawei thothawei closed this Jul 29, 2026
thothawei added a commit that referenced this pull request Jul 29, 2026
* fix(ws): 補上客戶端心跳,讓半開連線偵測得到(救回 PR #59 獨有的修正)

半開連線(對端沒了但本地收不到 FIN)不會觸發 onDone/onError,重連鏈永遠不啟動,
isConnected 仍是 true——司機靜靜地收不到派單。後端只做了另一半(54 秒 ping、
60 秒沒 pong 就砍連線),保護的是伺服器不留死連線。

改用 IOWebSocketChannel 並設 pingInterval=20 秒(對齊後端派單 offer 逾時的數量級),
收不到 pong 就關閉連線 → 走既有重連鏈。

測試:enableKeepAlive 在真 socket 上開啟 ping(先校準預設為 null,斷言非恆真)、
預設 connector 仍連得上且收得到事件。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* fix(driver): 停靠點在別處被標記時,這台也要跟上(救回 PR #61 獨有的修正)

同一司機的第二台裝置或 LINE 那條路徑標記到達/跳過時,這台的司機端不處理
ride.stop_updated——兩台會停在不同的「下一站」,而那正是唯一給操作按鈕的一站。
乘客端早就會收這則事件。後端側已於 dispatch#53 補推給司機。

修法:同一張單就以後端重讀 active(payload 沒有 phase/車資等欄位,重讀最不易對不齊),
失敗靜默(不是使用者按出來的動作,橫幅只會在他開車時干擾)。

測試:新增 driver_stop_updated_test.dart 3 案;反向確認拿掉修正後第 1 案 FAIL。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* fix(customer): 建單 409 也去跟後端對帳,並與建單成功共用狀態切換(救回 PR #60 獨有的修正)

409「已有進行中的訂單」是後端在明說有單,而乘客畫面上一張都沒有——多半是上一次
逾時其實建成了,或訂單來自 LINE/另一台裝置。只把這句話原樣顯示,乘客無路可走:
再按一次還是 409,唯一出路是重開 App。

同時把建單成功的狀態切換抽成 _applyCreatedRide 與「接手既有訂單」共用——
原本接手只做 _applyActiveRide,編輯中的多乘客清單、預估車資、上一趟的取消通知
都會留著帶進下一次叫車。

測試:新增 customer_create_conflict_test.dart 4 案;反向確認拿掉 409 分支後 2 案 FAIL。
全套 flutter analyze 無 issue、flutter test 277 passed。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* docs(app): 回填 PR 佇列稽核——兩條 stack 撞題、去重與救回的三項

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
thothawei added a commit that referenced this pull request Jul 29, 2026
* test(customer): 救回接手既有訂單的三個邊界(來自被取代的 PR #60)

關掉重複 PR 前逐檔比對,發現 #60 的 customer_place_order_timeout_test 裡有三條
main 完全沒有的斷言:接手時要一併帶出司機資訊(否則乘客會先看到一段假的「配對中」,
司機可能已經在門口)、對帳本身失敗時要維持原錯誤、後端回終態訂單時不算數
(把已完成的上一趟接手過來,乘客會盯著一張永遠不會動的行程)。

反向確認:拿掉 _applyActiveRide 與 isTerminal 判斷後,這三案中有 2 案 FAIL
(第三案「對帳失敗」由既有 catch 覆蓋,仍保留以釘住行為)。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* test(ws): 救回「登出後回前景不可偷偷連回去」(來自被取代的 PR #59)

回前景會呼叫 ensureConnected();漏看 _disposed 的話,已登出的 client 會帶著舊 token
重新連上,上一個帳號的事件就繼續進來。main 的 app_lifecycle_test 有「斷線立刻重連」
與「已連上不重建」,唯獨缺這條。

誠實標記:這是 defense-in-depth 的行為斷言,不是釘住某一行——
ensureConnected 與 _open() 各有一道 _disposed 守門,單獨拿掉任一道測試都仍 PASS,
兩道同時拿掉才 FAIL(connector 被呼叫 2 次)。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
@thothawei
thothawei deleted the claude/accept-create-outcome-reconcile branch July 29, 2026 06:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant