如何通过单次include实现可嵌套的Nginx自定义错误页代码段？

核心限制说明 #

Nginx语法层面不允许在location块内部嵌套定义另一个location，你原本的配置片段因为在location /app/里嵌套了location /ErrorPages/，会直接触发配置验证失败，这是无法绕过的硬性规则。

实现方案（一次Include复用逻辑） #

要做到「通过Include为不同Location选择性开启自定义错误页」，同时规避嵌套限制，可以按以下方式重构配置：

1. 拆分配置片段 #

将错误页的功能指令和资源Location分离，保证复用性：

片段1：错误页功能指令（snippets/error-pages.conf）

# 开启代理错误拦截
proxy_intercept_errors on;
# 定义错误页映射，可按需添加更多状态码
error_page 400 /ErrorPages/HTTP400.html;
error_page 403 /ErrorPages/HTTP403.html;
error_page 404 /ErrorPages/HTTP404.html;

片段2：错误页资源Location（snippets/error-pages-resource.conf）

# 错误页静态资源的Location，仅需定义一次
location /ErrorPages/ {
    alias /var/www/html/ErrorPages/;
    internal; # 仅允许内部跳转访问，禁止外部直接请求
}

2. 主配置文件引用 #

在Server块的顶级范围（所有Location之外）引入错误页资源Location，然后在需要自定义错误页的业务Location中引入功能指令片段：

server {
    ...
    # 仅引入一次错误页资源Location，全局生效
    include /etc/nginx/snippets/error-pages-resource.conf;

    # 需要自定义错误页的业务Location
    location /app/ {
        include /etc/nginx/snippets/error-pages.conf;
        proxy_pass ...;
        proxy_redirect default; 
    }

    # 不需要自定义错误页的业务Location，直接跳过Include
    location /api/ {
        proxy_pass ...;
        proxy_redirect default;
    }
}

关键逻辑说明 #

• proxy_intercept_errors和error_page是Location级别的可配置指令，在单个业务Location中引入即可为该Location开启自定义错误页
• /ErrorPages/的Location必须定义在Server级别，因为Nginx的Location匹配规则是全局的，不支持嵌套定义，且internal指令保证该路径只能被Nginx内部跳转访问，避免外部直接请求错误页资源

内容的提问来源于stack exchange，提问作者luart