Nginx中仅对根路径/根据$http_accept配置proxy_pass的报错解决问询

问题原因 #

你遇到的报错是因为Nginx的规则限制：不允许在if语句块、正则匹配location、命名location或limit_except块内使用带有URI部分的proxy_pass指令。原配置在location /的if里直接写proxy_pass https://api.example.org/homepage_jsonld/，违反了这个限制。

符合需求的解决方案 #

要实现「仅根路径/且Accept头为application/ld+json时转发到API，其余请求走本地静态文件」的需求，推荐用精确匹配根路径的方式拆分逻辑，避开if内带URI的proxy_pass：

# 精确匹配根路径请求
location = / {
    # 判断Accept头，满足条件时转发API
    if ($http_accept = 'application/ld+json') {
        # 先代理到API域名（不带URI）
        proxy_pass https://api.example.org;
        # 重写请求URI到目标路径
        rewrite ^ /homepage_jsonld/ break;
        # 可选：设置Host头确保API能正确识别请求
        proxy_set_header Host api.example.org;
    }

    # 不满足转发条件时，处理本地静态文件
    root /var/www/example.org/dist;
    try_files $uri $uri/ /index.html;
}

# 处理所有非根路径的静态请求
location / {
    root /var/www/example.org/dist;
    try_files $uri $uri/ /index.html;
}

配置说明 #

• location = /：精确匹配只有路径为/的请求，确保转发逻辑只在首页触发。
• rewrite ^ /homepage_jsonld/ break：将根路径的请求URI替换为API需要的路径，配合不带URI的proxy_pass完成转发，避开Nginx的规则限制。
• 两个location分工明确，非根路径的请求直接进入第二个块处理静态资源，逻辑清晰且符合Nginx的配置规范。

另一种可选方案（用map指令） #

如果偏好更简洁的变量式配置，可以提前用map指令组合请求路径和头信息判断条件：

# 组合请求路径和Accept头，匹配时设置代理目标
map "$request_uri:$http_accept" $proxy_target {
    ~^/:application/ld\+json$ https://api.example.org/homepage_jsonld/;
}

location / {
    # 如果匹配到代理目标，执行转发
    if ($proxy_target) {
        proxy_pass $proxy_target;
    }

    root /var/www/example.org/dist;
    try_files $uri $uri/ /index.html;
}

这种方式通过map预先计算是否需要转发，避免在if内直接写带URI的proxy_pass，同样能满足需求。

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