Chrome在處理檔案下載引發Resource interpreted警告

今天同事回報在網站的一個稀鬆平常的PDF檔案下載,在檔案正確下載到本地端的情況下,Google Chrome瀏覽器的DevTools(F12)中卻回報了下列字眼。

Resource interpreted as Document but transferred with MIME type application/octet-stream

由於該網站的檔案下載是由一個公用的類別統一去操作HttpContext,所以當下的直覺是Google Chrome也管太寬了,連我不老實的輸出MIME也要管,當我把System.Web.MimeMapping.GetMimeMapping動態判斷MIME的程式碼加入時,發現根本沒有用,檔案依然是正確下載了,但Google Chrome吐給我的警告也更WTF了!

Response Headers:
-----
Content-Disposition: attachment; filename="TEST.pdf"
Content-Type: application/pdf

Google Chrome DevTools (F12)
-----
Resource interpreted as Document but transferred with MIME type application/pdf

WTF?我的MIME都正確了還吐出警告?

開始瘋狂搜尋網路的討論,發現有這樣困擾的工程師還真不少,在各大論壇中都有人提出,但給的答案其實都無濟於事,有的人說要補上Content-Disposition,有的人說要補上Content-Length,拜託,這個我本來就都有了好嗎?

Google Chrome瀏覽器跟你警告的中譯是:資源被理解成一個文件,但是傳輸過來的MIME卻跟我說是一個PDF。然而,PDF就是文件吧?這個警告說明,再怎麼想也是正確的啊!

引發這個警告的「可能」原因

無意間在Chrome的Request Headers看到這行:

Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8

所以可能Google Chrome瀏覽器其實想要跟你講:我「預計收到」的是一個我想要的文件,你卻丟一個PDF檔案叫我去儲存,現在是三小情況?

突然一閃而過這個可能性時,心中的OS是,我正確的描述檔案MIME,並請你以attachment的型態去把檔案儲存也有事?

讓這個警告不再出現的方法

修改下載標籤

在a標籤的後面加上「download」屬性,叫瀏覽器用download的方式去處理這個連結,這個方法對Chrome有用,但對瀏覽器的相容性卻很有風險性,自己上Can I Use查看看便知到後果。

況且,修改全網站的a標籤的寫法,也不是一件好味道的事情。

採用公認標準寫法

基本上所謂的標準寫法,就是只打出Content-Type,而不在去輸出其他HTTP標頭,讓瀏覽器自己去判斷要怎麼處理這個MIME,這樣的做法會形成一些後果...

  1. 如果這個檔案是瀏覽器可以處理的檔案的話,那就不會出現警告。例如瀏覽器看到PDF檔案會用瀏覽器內建程式打開,你要嘛直接在裡面看,要嘛去點擊內建PDF瀏覽程式的下載按鈕將檔案下載。但你的PDF檔案名稱會以網址上面的最後連結文字(通常是一組UUID)當作是檔名。
  2. 承上,如果你想要自訂檔名而非以URL當作存檔名稱,那麼可以使用「Content-Disposition: inline; filename="TEST.pdf"」來解決。
  3. 遇到瀏覽器無法處理的MIME檔案,那警告還是會出現。例如ZIP檔案會引發自動下載,連Google自己的網站的ZIP下載也會發出類似的警告,詳見下方:
Resource interpreted as Document but transferred with MIME type application/octet-stream

永遠儲存檔案到本機寫法

基本上我自己是很討厭使用瀏覽器內建的PDF瀏覽器,或者是在瀏覽器中嵌入WORD之類的Viewer在裡面進行瀏覽操作行為,因此我對檔案下載的觀點就是,下載到我的本地端就好,你管我要怎麼使用?

在ASP.NET中的答案就是,不要輸出任何「Content-Type」,你Chrome不想聽我也不想講啊!只要載明「Content-Disposition: attachment; filename="TEST.pdf"」就好。在ASP.NET的機制下發現你沒有輸出Content-Type,就會自動幫你補上「Content-Type: text/html」,但在修補的過程中,你原本自行運算輸出的Content-Length也消失無蹤了,這意味著你喪失了檔案下載的進度觀測功能。

非ASP.NET的解法,也是自己直接硬輸出成「Content-Type: text/html」或「Content-Type: application/xhtml+xml」,讓瀏覽器認為這是text/html(符合預期),但瀏覽器又受到Content-Disposition控制,故不解釋它且直接儲存。

這下,DevTools(F12)就不會有任何警告啦!

後記:這篇文章只是在探討為何會發生這種錯誤,但最終我選擇做自己,我把所有正確的資訊都餵給瀏覽器,你Chrome要警告就警告吧,反正所有的下載功能也都是正常運行無誤。

GoogleChrome HttpHeader Content-Type Content-Disposition ResourceInterpretedAsDocument ButTransferredWithMimeType