nginxtry_files詳解

一、try_files概述

try_files是nginx中一個非常重要的指令，用於指定nginx在查找靜態文件時的順序。其語法為：

try_files file ... uri;

其中file表示nginx查找文件的路徑，可以指定多個路徑，以空格分隔。uri表示啟用動態頁面請求的URI地址。當nginx遇到需要查找靜態文件的請求時，它會按照指定的file順序查找文件，如果查找到了，nginx會直接返迴響應，否則nginx會請求uri對應的動態頁面。

二、try_files常見使用場景

1、前端路由處理：

location / {
    try_files $uri $uri/ /index.html;
    # $uri指請求的uri路徑，$uri/表示請求的uri路徑加上一個/，例如訪問example.com/path，則會依次嘗試訪問/path,/path/index.html,/index.html
    # /index.html表示如果仍未匹配到則重定向到index.html
}

這種場景多用於單頁應用，例如vue.js等前端框架的路由管理。當用戶在瀏覽器中訪問一個非根路徑的路徑時，由於這些路徑都是由前端路由管理的，nginx無法直接返回正確的靜態文件，因此需要將請求重定向到統一的路徑，這裡是/index.html，由前端路由控制頁面的展示。

2、圖片服務器：

location /images/ {
  root /data/www;
  error_page 404 = /fetch_image.php;
  try_files $uri $uri/ =404;
}
location /fetch_image.php {
  fastcgi_pass 127.0.0.1:9000;
  set $path_info "";
  fastcgi_param PATH_INFO $path_info;
  fastcgi_param SCRIPT_FILENAME /scripts/fetch_image.php;
  include fastcgi_params;
}

這種場景多用於圖片服務器，當用戶訪問圖片時，先嘗試在本地文件系統中查找是否有該文件，如果找到就返回；如果沒有找到則會轉發到fetch_image.php進行處理，從遠程資源服務器拉取圖片並返回給用戶。

三、try_files注意事項

1、路徑匹配規則：try_files會按照給定的路徑參數逐一進行查找，如果路徑中提供了/，則nginx會認為它是一個絕對路徑，並直接將其與root指令中指定的路徑進行拼接；如果路徑中沒有/，則nginx會認為它是一個相對路徑，並將其與當前請求的URI進行拼接，再與root指令中指定的路徑進行拼接。例如：

location / {
    root /data/www;
    try_files test.html /test.html;
    # 當請求example.com/時，nginx會依次嘗試訪問/data/www/test.html、/data/www/test.html/index.html和/data/www/index.html，如果都沒有找到則會返回404
}

2、設置HTTP頭：如果設置了try_files，可能會影響HTTP頭中的Content-Type和Content-Length，因此需要在配置文件中設置正確的HTTP頭。

location /images/ {
    root /data/images;
    try_files $uri /fallback.png;
    add_header Content-Type image/png;
}

四、try_files示例代碼

# 示例1：前端路由處理
location / {
    try_files $uri $uri/ /index.html;
}

# 示例2：圖片服務器
location /images/ {
  root /data/www;
  error_page 404 = /fetch_image.php;
  try_files $uri $uri/ =404;
}
location /fetch_image.php {
  fastcgi_pass 127.0.0.1:9000;
  set $path_info "";
  fastcgi_param PATH_INFO $path_info;
  fastcgi_param SCRIPT_FILENAME /scripts/fetch_image.php;
  include fastcgi_params;
}

# 示例3：設置HTTP頭
location /images/ {
    root /data/images;
    try_files $uri /fallback.png;
    add_header Content-Type image/png;
}