Nginx使用变量设置proxy_read_timeout报错，如何实现动态上游超时？

proxy_read_timeout指令确实不支持直接使用变量赋值，这就是你配置proxy_read_timeout $upstream_read_timeout;时报错的原因。但并非完全无法实现动态超时，以下是几种可行方案：

方案一：用map指令匹配场景映射超时值 #

通过map指令根据请求特征（如请求头、域名、URI等）预定义映射关系，将对应值传入proxy_read_timeout。这种方式是静态预配置，但能覆盖多数动态场景需求。

示例配置：

http {
    map $http_x_timeout $dynamic_timeout {
        default 60s;
        120s 120s;
        300s 300s;
    }

    server {
        location / {
            proxy_read_timeout $dynamic_timeout;
            proxy_pass http://your_upstream;
        }
    }
}

此配置通过自定义请求头X-Timeout传递超时值，map会根据请求头内容匹配对应超时时间，默认使用60秒。

方案二：使用Nginx Plus动态配置API #

若使用Nginx Plus（商业版），可通过官方API动态修改proxy_read_timeout值，支持针对不同上游服务、请求路径单独设置，无需重启Nginx。

示例操作命令：

curl -X PATCH -d '{"proxy_read_timeout": 120}' http://nginx-plus-api:8080/api/conf/http/servers/server_1/locations/location_1

方案三：基于OpenResty的Lua脚本动态设置 #

OpenResty作为Nginx的扩展版本，支持Lua脚本在运行时动态调整配置。可通过Lua代码根据请求参数、业务逻辑修改超时变量，再传入proxy_read_timeout。

示例配置：

http {
    server {
        location / {
            set $timeout 60s;
            access_by_lua_block {
                -- 根据请求参数动态调整超时
                local req_timeout = ngx.var.arg_timeout
                if req_timeout and tonumber(req_timeout) > 0 then
                    ngx.var.timeout = req_timeout .. "s"
                end
            }
            proxy_read_timeout $timeout;
            proxy_pass http://your_upstream;
        }
    }
}

此配置通过请求参数timeout传递自定义超时值，Lua代码在请求处理阶段修改变量，进而动态设置超时时间。

方案四：拆分配置块实现差异化超时 #

若动态超时需求基于不同上游服务或请求路径，可直接在不同location或server块中单独设置proxy_read_timeout，这是最直接的静态拆分方式。

示例：

server {
    location /api/fast {
        proxy_read_timeout 30s;
        proxy_pass http://fast_upstream;
    }

    location /api/slow {
        proxy_read_timeout 300s;
        proxy_pass http://slow_upstream;
    }
}

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