Nginx 的 try_files 指令用于尝试一个或多个文件路径或 URI，以处理客户端请求。如果找到一个文件或 URI 存在，则返回该文件或执行该 URI。如果没有找到，则返回一个指定的错误码或重定向到一个默认的处理程序。try_files 指令通常用于静态文件服务、动态内容处理和错误处理。

语法

try_files file1 [file2 ... filen] uri|=code;

file1, file2, ... filen: 依次检查这些文件或目录的存在性。
uri: 如果前面的文件或目录都不存在，重定向到指定的 URI。
=code: 如果前面的文件或目录都不存在，返回指定的 HTTP 状态码。

示例

静态文件服务

优先返回静态文件，如果文件不存在，则返回 404 错误。

server {
    listen 80;
    server_name example.com;

    location / {
        root /var/www/html;
        try_files $uri $uri/ =404;
    }
}

动态内容处理

优先返回静态文件，如果文件不存在，则将请求重定向到一个 PHP 处理程序。

server {
    listen 80;
    server_name example.com;

    location / {
        root /var/www/html;
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        root /var/www/html;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

单页应用（SPA）

所有路径都指向入口的 index.html 文件，以支持前端路由。

server {
    listen 80;
    server_name example.com;

    location / {
        root /var/www/html;
        try_files $uri $uri/ /index.html;
    }
}

工作原理

尝试多个文件路径：按顺序检查指定的文件或目录是否存在。如果找到一个存在的文件或目录，则立即返回该文件或目录。
重定向到 URI：如果所有指定的文件或目录都不存在，则重定向到一个指定的 URI。这通常用于将请求传递给动态处理程序。
返回指定的 HTTP 状态码：如果所有指定的文件或目录都不存在，并且未指定 URI，则返回指定的 HTTP 状态码（如 404）。

优点

灵活性高：可以轻松处理静态文件、动态内容和错误处理。
配置简洁：通过一条指令即可实现多种路径检查和处理逻辑。
性能优化：优先处理静态文件，避免不必要的动态处理，提高响应速度。

缺点

调试困难：由于会依次检查多个路径，调试和排查问题时可能比较复杂。
灵活性有限：无法进行条件判断或复杂的重写规则处理，需要结合其他指令使用。
错误处理简单：只能指定简单的错误处理方式，无法进行复杂的错误处理逻辑。

总结

Nginx 的 try_files 指令是一种非常强大和灵活的工具，适用于处理多种请求路径和文件检查需求。

通过适当的配置，可以显著提高服务器的性能和响应速度，同时简化配置文件的编写和维护。

java 实现

整体思路

1）遍历非最后一个的 uri，替换占位符，判断文件是否存在，存在则返回。

2）判断最后一个 uri 或者 code，直接处理对应的逻辑。

核心逻辑

/**
 * try_files path1 path2 ... final;
 *
 * - `path1`, `path2`, ...：要检查的文件或 URI 列表。可以是相对路径或绝对路径。
 *
 * - `final`：如果前面的所有路径都不存在，最后一个参数可以是一个 URI，Nginx 将内部重定向到该 URI，或者是一个 HTTP 状态码（如 404），用于返回相应的错误。
 *
 * @see INginxPlaceholder 占位符
 * @see com.github.houbb.nginx4j.support.request.dispatch.http.NginxRequestDispatchHttpReturn 设置对应的返回码 =xxx
 */
public class NginxTryFilesDefault implements INginxTryFiles{

    private static final Log log = LogFactory.getLog(NginxTryFilesDefault.class);

    /**
     * 处理 try_files 指令
     *
     * @param request     请求
     * @param nginxConfig 配置
     * @param context     上下文
     */
    public void tryFiles(FullHttpRequest request,
                         final NginxConfig nginxConfig,
                         NginxRequestDispatchContext context) {
        // 获取当前的 location
        List<NginxCommonConfigEntry> directiveList = InnerNginxContextUtil.getLocationDirectives(context);
        Map<String, List<NginxCommonConfigEntry>> directiveMap = InnerNginxContextUtil.getLocationDirectiveMap(directiveList);

        List<NginxCommonConfigEntry> tryFiles = directiveMap.get(NginxDirectiveEnum.TRY_FILES.getCode());
        if(CollectionUtil.isEmpty(tryFiles)) {
            return;
        }

        NginxCommonConfigEntry firstEntry = tryFiles.get(0);

        // 遍历非 final 的文件信息
        String notFinalUri = getNotFinalMatchedFileUri(firstEntry, context);
        if(StringUtil.isNotEmpty(notFinalUri)) {
            request.setUri(notFinalUri);
            return;
        }

        // 判断 final 变量
        final String lastUri = firstEntry.getValues().get(firstEntry.getValues().size()-1);
        if(lastUri.startsWith("=")) {
            // 拆分为 return
            NginxReturnResult result = new NginxReturnResult();
            result.setCode(Integer.parseInt(lastUri.substring(1)));
            result.setValue("try_files final");
            context.setNginxReturnResult(result);
            return;
        }

        String lastReplaceUri = replacePlaceholders(lastUri, context.getPlaceholderMap());
        request.setUri(lastReplaceUri);
    }

    /**
     * 获取匹配的文件 url
     * @param entry 实体
     * @param context 上下文
     * @return 结果
     */
    private String getNotFinalMatchedFileUri(final NginxCommonConfigEntry entry,
                                            NginxRequestDispatchContext context) {
        List<String> values = entry.getValues();

        for(int i = 0; i < values.size()-1; i++) {
            String replacedUri = getMatchedFileUri(values.get(i), context);

            if(StringUtil.isNotEmpty(replacedUri)) {
                return replacedUri;
            }
        }

        return null;
    }

    private String getMatchedFileUri(final String requestUri,
                                     NginxRequestDispatchContext context) {
        final Map<String, Object> replaceMap = context.getPlaceholderMap();

        String replacedUri = replacePlaceholders(requestUri, replaceMap);

        // 判断文件是否存
        File file = InnerFileUtil.getTargetFile(replacedUri, context);
        if(file.exists()) {
            log.info("Nginx getMatchedFileUri file={}", file.getAbsolutePath());
            return replacedUri;
        }

    return null;
    }

    /**
     * 替换字符串中的占位符
     *
     * @param input    用户输入的字符串，包含占位符
     * @param variables 存储占位符及其替换值的 Map
     * @return 替换后的字符串
     */
    public static String replacePlaceholders(String input, Map<String, Object> variables) {
        // 使用 StringBuilder 来构建替换后的字符串
        StringBuilder result = new StringBuilder(input);

        // 遍历 Map 进行替换
        for (Map.Entry<String, Object> entry : variables.entrySet()) {
            String placeholder = entry.getKey();
            String replacement = String.valueOf(entry.getValue());

            // 使用 String 的 replace 方法替换所有占位符
            int start = result.indexOf(placeholder);
            while (start != -1) {
                result.replace(start, start + placeholder.length(), replacement);
                start = result.indexOf(placeholder, start + replacement.length());
            }
        }

        return result.toString();
    }

}

小结

Nginx 的 try_files 指令是一个强大且灵活的工具，用于处理静态文件、友好 URL 重写和自定义错误处理。

它通过按顺序检查多个路径并执行相应操作，使配置文件更加简洁和高效。

主要用途

静态文件服务：首先尝试提供静态文件，如果找不到则执行其他操作。
友好 URL 重写：用于支持伪静态 URL，将请求重写到实际的文件路径或动态脚本。
错误处理：如果所有尝试的文件都不存在，则返回一个特定的错误页面。

工作机制

try_files 按顺序检查列出的每个路径。
如果找到了一个存在的文件或目录，则立即停止进一步检查并使用该文件或目录响应请求。
如果所有列出的路径都不存在，则执行最后指定的 URI，这通常是一个错误页面或其他处理逻辑。

优点

高效静态文件处理：减少了不必要的动态请求处理。
灵活的错误处理：可以轻松配置自定义错误页面或重写规则。
简洁配置：使复杂的文件查找和重写逻辑更加直观和易于管理。

热门相关：万界点名册世界第一校长龙皇武神大周仙吏剑斗九天