upload_pass_args
在文件上传期间，`upload_pass_args` 指令决定是否将原始请求的查询参数传递到目标 URI。
NGINX module for handling file uploads
·
httpserverlocationif in locationlimit_except
语法upload_pass_args on | off;
默认值off
上下文http, server, location, if in location, limit_except
参数flag
说明
upload_pass_args 指令是 NGINX 用于通过 multipart/form-data 编码处理文件上传的模块的一部分。当此指令启用（设置为 'on'）时，它指示 NGINX 将原始请求的查询参数传递到 upload_pass 指令指定的位置。如果该指令设置为 'off'，则查询参数不会被转发，从而可以更有控制地处理上传的数据，避免意外的查询参数影响目标的处理。
该指令会影响通过文件上传模块处理的请求的行为。发生上传时，NGINX 通常会从请求中剥离文件字段，并将处理后的请求重定向到定义的处理位置。是否也传递随附的参数取决于 upload_pass_args 指令的配置，从而为数据流提供了灵活性和控制。
需要注意的是，被传递的参数将保留其原始名称和值，这对于在处理位置进行日志记录或额外处理是有益的。然而，应注意确保转发的参数不会破坏安全性或在目标处理程序的处理逻辑中造成冲突。
配置示例
location /upload {
upload_pass /handle_upload;
upload_pass_args on;
upload store /tmp/uploads;
}⚠
在需要处理查询参数时忘记将 upload_pass_args 设置为 'on'。
⚠
错误配置 upload_pass 指令且未正确处理，可能在传递参数时导致意外行为。