← ishizakahiroshi.com
設計判断 5分で読める要約版 2026-11-21

ポーリングを残したまま秒速化。Cloudflare Workers + Durable Objects に、認証を壊さず WebSocket 通知を足した話

看板から作業AIへ通知が飛ぶ様子を描いたヘッダー画像

個人で回している作業看板で、「任せる」を押してから作業AIが動き始めるまで、平均で約30秒かかっていました。既存の認証もポーリングも変えずにWebSocket通知だけを足し、押した直後の1秒未満で動くようにした記録です。

Qiita で全文を読む →

壊したくないものを先に並べた

看板には「仕事を任せる」ボタンがあり、押すとVPSにいる作業AI(拾い手)が仕事を取りに来ます。従来はcronで1分ごとに見に行くだけで、押してから動くまで平均約30秒、最悪60秒待ちでした。

即時化にあたり、守る条件を決めました。認証はBearerトークン一本のまま。前段のCloudflare Accessの設定も変えない。ポーリングは消さず、通知はあくまでヒントとして、切れても従来どおり拾える。鍵ファイル、日次の実行上限、STOPファイル、二重起動防止のlockも全部そのままです。

新しいパスを作らず、既存のAPIと同じパスに乗せる

新しい監視用エンドポイントを作ると、認証とAccessの設定をそちらにも揃える必要が出ます。そこで、認証ライブラリがAPIのパスの配下も同じ保護リソースとして扱うことに着目しました。MCPのURLにGETとUpgradeのヘッダを投げれば、既存の認証・Accessのバイパス・鍵の監査がそのまま効くWebSocket経路になります。

看板本体のDurable Objectは、Hibernation WebSocket APIで受けます。誰が待っているかはメモリではなくソケットの付属情報に持ち、通知のたびに「いま仕事が待っている宛先」をSQLiteに聞き直します。拾い手側は新しい--watchモードを足しただけで、合図を受けたら既存のpassを1回呼びます。通知専用の拾い方は作りません。

pollとwake通知の2経路が同じpassに合流する構成図
wakeは合図、正本はpoll。2つの経路が同じpassに合流します。

本番で見えた、自分が自分を起こすバグ

本番で測ると、wakeが1回のはずなのに300msで4回連鎖しました。原因は「tool呼び出しのあとに全部通知を評価する」設計です。起きた拾い手のpassが看板を呼ぶと、その呼び出しでまた通知が評価され、拾えない仕事が残っているかぎり自分のpassが自分を再び起こしていました。

対処は、同じ待ち状態では1度送ったら二度と送らないという重複排除です。ソケットに送信済みの印を持たせ、待ちが解消したら戻します。試験にも、再送されないことと、再依頼で再びwakeすることを足しました。

実測と、まとめ

本番では、handoffを書き込んでからwake passが始まるまで191ms、画面の「任せる」から受付開始まで1秒未満でした。デプロイでDurable Objectが再起動してソケットが切れた間も、60秒ごとのpollは走り続け、フォールバックが本番で働くことも確かめられました。STOP・日次上限・lockは何も変わりません。

認証したいAPIと同じパスへのUpgradeにすると経路を増やさずに済み、通知はヒントとして正本のpollを残す。この二つで、戻すときも常駐プロセスを止めて旧版をデプロイするだけです。細かいコードと手順は全文にあります。

もっと深く読みたい人へ

コードの抜粋、拾い手側の実装、計測の詳細は、Qiitaの全文にまとめています。

Qiita で全文を読む →