
大きなPDFの表示が始まらない――FastAPIのFileResponseがRange非対応だったので、206 Partial Contentを自前で返した
自宅のNASには、自炊して巻ごとにPDF化した本がまとまって置いてあります。これをスマホやタブレットのブラウザで読めるように、FastAPIで小さなビューアを作りました。やることは「NAS上のPDFをそのまま返す」だけで、変換もサムネイル生成もしない薄いアプリです。
ところが、100MBを超えるPDFを開くと、1ページ目が出るまでにかなり待たされました。原因は、HTTPのRangeリクエストに応えていなかったことでした。この記事では、その原因と、206 Partial Contentを自前で返す実装、そして記事を書くためにコードを読み返していて見つけた取りこぼしを紹介します。
症状:ファイル全体を落とし切るまで表示されない
最初の実装は、FileResponseを返すだけでした。
@app.get("/api/pdf/{volume_id}")
def api_pdf(volume_id: str):
path = library.resolve_pdf_path(volume_id)
return FileResponse(path, media_type="application/pdf")ブラウザ内蔵のPDFビューアは、サーバーが「Accept-Ranges: bytes」を返し、Rangeリクエストに206で応えてくれる場合、ファイルの必要な部分だけを先に取りに行けます。PDFは末尾に目次のような相互参照表を持っているので、まず末尾を読みに行くことが多いのです。サーバーがRange非対応だと、全体のダウンロードが終わるのを待つしかありません。
使っていたStarletteは0.37.2で、このバージョンのFileResponseはRangeヘッダを見ずに、常に200でファイル全体を返していました。新しいバージョンでは対応が入っているので、同じ症状に出会ったら、まずバージョンを確認するのが一番早い解決策です。今回はエンドポイント側で自前実装することにしました。