フロントのreact-pdf等で 'Failed to load PDF file.' が出る場合、本質はAPIが有効なPDFを返せていないこと。典型原因は、API側がエラー時にも Content-Type: application/pdf でストリームを開始済みで、壊れた/空のBlobがフロントに渡るケース。切り分けは、レスポンス本文先頭が %PDF- か、実ステータスとcontent-typeを確認する。対策はサーバ側でストリーム開始前にエラーをHTTPエラーとして返し、response.okだけでなくcontent-typeが application/pdf かも検証する。