Nginx配置异常：/pdf路径try_files失效，React PDF应用无法响应

你遇到的核心问题是：使用root配置时，Nginx会将请求URI拼接在root指定的路径后，导致无法找到PDF应用的index.html，最终请求回退到主应用的/规则处理。以下是两种可行的修正方案：

方案一：使用alias替代root（推荐） #

alias会直接将请求URI中的/pdf部分替换为指定的目录路径，更适配React应用的路由结构：

server {
    listen       8080;

    ## 匹配所有 /pdf 和 /pdf/* 请求
    location /pdf {
      alias /Users/aronlilland/Documents/dev/backbone-ui/applications/pdf-renderer/build;
      add_header Cache-Control no-cache;
      # 优先匹配静态文件，无匹配时加载PDF应用的入口文件
      try_files $uri $uri/ /pdf/index.html;
    }
 
    ## 其他所有请求指向主应用
    location / {
      root /Users/aronlilland/Documents/dev/backbone-ui/applications/backbone/dist;
      add_header Cache-Control no-cache;
      try_files $uri $uri/ /index.html;
    }
}

方案二：保留root，指定绝对路径的入口文件 #

如果不想修改root配置，可以将try_files的兜底路径改为PDF应用index.html的绝对路径，避免回退到主应用：

server {
    listen       8080;

    ## 精确匹配 /pdf
    location = /pdf {
      root /Users/aronlilland/Documents/dev/backbone-ui/applications/pdf-renderer/build;
      add_header Cache-Control no-cache;
      try_files $uri $uri/ /Users/aronlilland/Documents/dev/backbone-ui/applications/pdf-renderer/build/index.html;
    }

    ## 匹配所有 /pdf/* 请求
    location /pdf {
      root /Users/aronlilland/Documents/dev/backbone-ui/applications/pdf-renderer/build;
      add_header Cache-Control no-cache;
      try_files $uri $uri/ /Users/aronlilland/Documents/dev/backbone-ui/applications/pdf-renderer/build/index.html;
    }
 
    ## 其他所有请求指向主应用
    location / {
      root /Users/aronlilland/Documents/dev/backbone-ui/applications/backbone/dist;
      add_header Cache-Control no-cache;
      try_files $uri $uri/ /index.html;
    }
}

生效步骤 #

修改配置后，执行以下命令重载Nginx使配置生效：

nginx -s reload

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