如何在Nginx配置中拒绝带查询参数的URL并返回4xx状态码？

完全可以通过Nginx配置实现这个需求，核心是利用Nginx内置变量识别请求URL是否包含查询参数，再针对性处理。

核心逻辑 #

Nginx提供两个关键变量用于判断查询参数：

• $is_args：仅当URL存在?时，值为?；无查询参数时为空字符串，能精准匹配所有带?的请求（包括仅?无参数的情况）。
• $query_string：存储?后面的参数内容，无实际参数时为空，可用于区分“仅带?无参数”和“带参数”的请求。

配置示例1：拒绝所有带?的请求 #

这是最贴合需求的写法，只要URL里有?，无论后面有没有参数都直接拒绝：

server {
    listen 80;
    server_name example.com;

    # 检测到URL带?，直接返回403禁止访问
    if ($is_args = "?") {
        return 403;
    }

    # 正常处理无查询参数的请求
    root /path/to/your/web-files;
    index index.html index.htm;
    # 如果是反向代理场景，替换为proxy_pass配置
    # proxy_pass http://your-backend-server;
}

配置示例2：仅拒绝带有实际参数的请求 #

如果需要允许https://example.com/?这种仅带?但无参数的请求，可以用$query_string判断：

server {
    listen 80;
    server_name example.com;

    # 仅当存在实际查询参数时拒绝
    if ($query_string != "") {
        return 403;
    }

    # 正常处理逻辑
    root /path/to/your/web-files;
    index index.html;
}

补充说明 #

• 可根据需求替换返回状态码：比如用return 404;返回“资源不存在”，或return 400;返回“错误请求”；
• 若部署HTTPS服务，需在server块中添加listen 443 ssl;及对应的SSL证书配置；
• 这里的if指令逻辑简单，不会触发Nginx复杂场景下的优先级陷阱，可放心使用。

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