Instagramメディア公開の二段階処理――R2保存・Range配信・publish状態

大きな動画の配信とMetaへのpublishが失敗したとき、素材保存成功と投稿公開成功をどう区別するか。

コードから観測できること

1. media posts route、publish service、DB module、validation/publish testsが存在し、素材管理と公開処理を別状態として扱う。
2. images routeにはRange testがあり、大きなmediaを部分応答できることが検証対象になっている。HTTP Range成功とInstagram公開成功は別の結果である。
3. media posts migrationは投稿状態を永続化する。再試行時に新しい投稿を重複作成しないため、Meta側container IDや公開結果との対応が必要になる。

再現・追加測定の手順

1. 正常画像・不正形式・大きな動画を登録する
2. Range requestの境界値を試す
3. container作成後・publish前後で失敗を注入する
4. R2 object、D1状態、Instagram投稿を照合する

この資料だけでは証明できないこと

1. media encoding要件はMeta側変更の影響を受ける。
2. R2から取得できることは著作権・投稿権限を保証しない。

このページは新しいcommit、実測ログ、API仕様変更が得られた時点で更新します。古い観測条件と現在仕様を混同しないため、固定commitへのリンクを残します。