为Nginx特定路径/api/import设置proxy_read_timeout遇404问题求助

问题根源 #

你添加的location /api/import块仅设置了proxy_read_timeout，但未包含任何代理转发规则，Nginx无法处理该请求，因此返回404；同时Nginx的location匹配逻辑会优先匹配更具体的路径，匹配到该块后不会再执行后续的location /规则。

解决方案 #

方案一：用map动态设置超时（推荐，无需额外location） #

通过map指令根据请求路径动态设置超时时间，所有请求仍走原有的代理逻辑，无需复制配置，也不会出现404问题：

修改后的server块配置：

server {
    # 新增map规则，根据路径匹配对应超时值
    map $request_uri $proxy_read_timeout_value {
        ~^/api/import  10m;
        default        60s; # 替换为你原本的默认超时时间
    }

    ...

    location / {
        {% if websocket_support == true %}
        # Next three lines enable websocket support
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        {% endif %}
        proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header        Host $http_host;
        proxy_set_header        X-Forwarded-Proto $real_scheme;
        proxy_redirect          off;
        
        # 替换原有固定超时值，使用动态变量
        proxy_read_timeout $proxy_read_timeout_value;

        if (!-f $request_filename) {
            proxy_pass  http://socket_server${unique_suffix};
            break;
        }
    }

    location ~ \.php$ {
        deny  all;
    }
}

当请求路径以/api/import开头时，超时自动设为10分钟，其他请求沿用默认超时，完全不破坏原有代理逻辑。

方案二：复用代理配置片段（适合需添加更多专属配置的场景） #

如果后续需要给/api/import添加更多专属配置，可以把通用代理逻辑抽成独立片段，再在两个location中引用：

1. 创建通用代理配置片段（比如proxy_common.conf，Cloud66中可通过自定义配置文件或模板变量实现）：

{% if websocket_support == true %}
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
{% endif %}
proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header        Host $http_host;
proxy_set_header        X-Forwarded-Proto $real_scheme;
proxy_redirect          off;

if (!-f $request_filename) {
    proxy_pass  http://socket_server${unique_suffix};
    break;
}

2. 修改server块配置，引用该片段：

server {
    ...

    location /api/import {
        proxy_read_timeout 10m;
        include /path/to/proxy_common.conf; # 替换为实际文件路径
    }

    location / {
        include /path/to/proxy_common.conf;
    }

    location ~ \.php$ {
        deny  all;
    }
}

这样既保留了/api/import的专属超时设置，又复用了通用代理配置，避免重复编写代码。

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