快捷導(dǎo)航

Nginx使用try_files遇到的問題及解決

更新時(shí)間：2025年10月10日 09:49:02 作者：葡萄糖o_o

這篇文章主要介紹了Nginx使用try_files遇到的問題及解決,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

背景

root /some/path;
location / {
	try_files $uri $uri/ /dist/index.html;
}

使用React之類的的庫(kù)來開發(fā)前端頁(yè)面的時(shí)候，因?yàn)槭菃雾?yè)應(yīng)用所以需要上面的Nginx配置，用來在找不到html文件的時(shí)候內(nèi)部重定向到/dist/index.html文件。

服務(wù)器上的目錄結(jié)構(gòu)是/some/path/dist/assetes網(wǎng)站的靜態(tài)資源都是存在/some/path/dist/下的，而服務(wù)器的根目錄是/some/path/。

域名：localhost.abc.com

現(xiàn)象：訪問localhost.abc.com/dist/正常訪問，訪問localhost.abc.com/dist/xxx等都正常，而直接通過域名localhost.abc.com訪問頁(yè)面則出現(xiàn)403錯(cuò)誤。

當(dāng)訪問域名會(huì)被location /塊捕獲，這是毋庸置疑的，匹配到之后，try_files 會(huì)嘗試第一個(gè)參數(shù) / （當(dāng)前的$uri是 / ）也就是/app/app/下只有一個(gè)文件夾dist，也沒有index.html或者index.htm文件，所以找不到，應(yīng)該是404，然后繼續(xù)找 // （這個(gè) // 會(huì)被如何解析不得而知）也找不到404，所以最后會(huì)知道 /some/path/dist/index.html 這個(gè)文件是存在的，所以不應(yīng)該出現(xiàn)403錯(cuò)誤，應(yīng)該正常展示才對(duì)。

遇到上面的問題主要是因?yàn)镹ginx的匹配流程不熟悉導(dǎo)致的，在訪問文件夾的時(shí)候，如果沒有找到index配置的文件，例如index.html之類的，那么會(huì)繼續(xù)調(diào)用autoIndex模塊，autoIndex模塊的值默認(rèn)是false，所以就報(bào)沒有權(quán)限查看這個(gè)文件夾的異常，異常碼是403。

try_files 是不會(huì)處理403這個(gè)異常的，try_files處理的是異常碼404，所以403這個(gè)異常就被直接返回出去了，也就是說在第一步匹配 / 的時(shí)候就直接返回了。

解決

即使開啟autoIndex對(duì)于單頁(yè)應(yīng)用來說也是十分奇怪的。所以我們可以設(shè)置root: /some/path/dist/這樣，即使訪問的是/那么第一個(gè)匹配的也是 /some/path/dist/index.html，就不會(huì)出現(xiàn)訪問域名直接報(bào)錯(cuò)的尷尬情況。

但是這個(gè)問題其實(shí)沒有解決，例如/some/path/dist/xxx/這個(gè)目錄通過域名訪問還是存在上面說的問題，/dist/xxx/這個(gè)訪問還是會(huì)報(bào)403但是這也無法避免，這其實(shí)是我們配置導(dǎo)致的（如上所述）。

除了修改root值的解決方案，我們還可以捕獲403這個(gè)錯(cuò)誤，然后再重定向到我們的目標(biāo)文件/some/path/dist/index.html。這就從根本解決了這個(gè)問題，但是我們網(wǎng)站也沒有了403錯(cuò)誤，這樣解決是否合適，有待商榷。