バックフィルのハング対策とエラー可視化

[hideack]

背景

起動時バックフィルが Backfill progress: 0/38 channels (0%), 0 messages fetched を延々と出力したまま完了せずハングする事象が発生していた。

進捗ログは30秒インターバル(lib/core.js:749)とバッチ完了時(lib/core.js:753)から出力される。processedChannels は成功・失敗どちらでも fetchChannel 末尾で必ずインクリメントされるため、これが 0 のまま = 最初のバッチのチャンネルすら1つも完了していない、つまり web.conversations.history() の await でハングしていると判断した。

原因

• バックフィル用の web クライアントが retryConfig 未指定で、Slack SDK デフォルトの tenRetriesInAboutThirtyMinutes が効いていた。
• conversations.history はレートリミットが厳しく、起動時に38チャンネルへ concurrency 5 で一斉に叩くと即 429 を食らい、約30分サイレントにリトライし続けてハングしていた。
• fetchChannel の catch がエラーを握りつぶしており(return のみ)、レートリミットなのかスコープ不足なのか原因がログに残らなかった。

変更内容

• web クライアントのリトライを retryPolicies.fiveRetriesInFiveMinutes に短縮し、長時間ハングを防止
• fetchChannel の catch でエラー種別(ratelimited / missing_scope / not_in_channel 等)をチャンネルラベル付きで出力
• バックフィルの同時実行数を 5→2 に抑制してレートリミットを踏みにくくする

テスト

• npm test(lint + mocha)全て通過(62 passing)

🤖 Generated with Claude Code