在 nginx 中使用 try_files 处理动态参数时，默认行为会丢弃 url 中的查询字符串（即问号及之后的内容），导致后端服务无法获取原始参数。要解决这个问题，必须在 try_files 的最后一个 fallback 路径后显式添加 $is_args$args 变量，这样 nginx 才会将原始的查询参数拼接到重写后的 uri 上传递给后端。
为什么 try_files 会丢失参数
try_files 指令在处理文件匹配失败并执行内部重定向时，默认只传递 URI 部分，不包含查询字符串。这意味着如果请求是 /api/data?user=123，而该文件不存在，Nginx 将其转发给后端时可能变成 /fallback，导致 ?user=123 丢失。这是 Nginx 的设计机制，旨在避免将静态文件的查找逻辑与动态参数混淆，但在需要保留参数的场景下必须手动干预。
server {
listen 80;
server_name example.com;
# 错误写法：参数丢失
location /api/ {
try_files $uri $uri/ /fallback;
}
# 正确写法：保留参数
location /api/ {
try_files $uri $uri/ /fallback$is_args$args;
}
}
在上述配置中，第一处 location 会导致参数丢失，第二处通过追加 $is_args$args 确保了参数完整传递。$is_args 在存在参数时返回 ?，否则返回空字符串；$args 包含完整的查询字符串。这种组合能安全地处理有无参数的两种情况。
如何验证参数是否成功传递
验证参数传递是否正确，最直接的方法是检查后端服务的访问日志或响应内容。当使用正确的 try_files 配置时，后端应能接收到包含原始查询字符串的请求。可以通过一个简单的 Python HTTP 服务器或 Nginx 的 access_log 格式来观察实际传入的参数。
# Nginx access_log 配置示例，用于观察传入的 URI
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$args"';
# 或者在后端代码中打印 request.query_params
from flask import Flask, request
app = Flask(__name__)
@app.route('/fallback')
def fallback():
return f"Received args: {request.args}"
通过上述代码，当请求 /api/test?key=value 时，若配置正确，后端将返回 Received args: key=value。若配置错误，则返回 Received args: 。这证实了 $is_args$args 在保留动态参数中的关键作用。开发者在排查此类问题时，应优先检查 try_files 末尾是否遗漏了该变量组合。
基于 fallback 路径的具体问题
当 try_files 的最后一个参数是一个具体的 URI 路径（如 /index.html）而非文件名时，同样需要遵循参数保留规则。例如，在单页应用（SPA）中，通常将所有路由指向 /index.html，此时必须写成 try_files $uri $uri/ /index.html$is_args$args;，否则所有带参数的 SPA 路由都将失效。这一细节在配置前端静态资源托管时尤为关键，确保开发者和运维人员不会因忽略参数拼接而导致功能异常。
