Nginx反向代理Docker部署的phpMyAdmin参数传递异常问题

我之前也踩过一模一样的坑！你遇到的「Missing parameter」错误，核心原因是Nginx在反向代理时没有把查询字符串（?后面的参数）正确传递给phpMyAdmin容器，尤其是当你用正则匹配或者自定义路径映射的时候。

分析你的两种规则问题： #

1. 第一种正则匹配规则：
   你的proxy_pass http://phpmyadmin/$2;只传递了路径部分（$2匹配的内容），但完全丢弃了?及后面的查询参数。比如访问example.com/admin-sql/js/get_scripts.js.php?scripts[]=xxx时，实际传递给phpMyAdmin的只有/js/get_scripts.js.php，参数没了，自然会提示缺失。

2. 第二种前缀匹配规则：
   这个规则本身理论上会自动传递查询参数，但可能因为PMA_ABSOLUTE_URI设置不规范（比如少了结尾的斜杠），或者phpMyAdmin没有正确识别反向代理后的请求URI，导致参数处理异常。

解决方案： #

方案1：修复正则匹配规则（推荐）

在proxy_pass的结尾加上$is_args$args，强制传递查询参数：

location ~ /admin-sql(/?)(.*) {
    proxy_pass http://phpmyadmin/$2$is_args$args;  # 关键：加上$is_args$args
    proxy_redirect off;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Host $server_name;
    # 如果是HTTPS环境，还要加上下面这行
    # proxy_set_header X-Forwarded-Proto $scheme;
}

• $is_args：如果请求有查询参数，输出?；没有则为空字符串
• $args：完整的查询参数内容（比如scripts[]=jquery/jquery.ba-hashchange-1.3.js）

方案2：优化前缀匹配规则+正确配置phpMyAdmin

如果你想用第二种规则，需要确保两点：

1. Nginx规则里添加proxy_set_header X-Forwarded-Uri $request_uri;，让phpMyAdmin能拿到完整的请求URI：

location /admin-sql/ {
    proxy_pass http://phpmyadmin/;
    proxy_redirect off;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Host $server_name;
    proxy_set_header X-Forwarded-Uri $request_uri;  # 新增这行
    # HTTPS环境加：proxy_set_header X-Forwarded-Proto $scheme;
}

2. 确保phpMyAdmin的PMA_ABSOLUTE_URI设置为带结尾斜杠的完整路径：

   # 启动phpMyAdmin容器时设置环境变量
   docker run -e PMA_ABSOLUTE_URI="http://example.com/admin-sql/" ... phpmyadmin/phpmyadmin
   

   结尾的斜杠很重要，不然phpMyAdmin生成的内部URL会缺失前缀，导致资源加载或参数传递异常。

验证方法 #

修改完Nginx配置后，重启Nginx容器：

docker exec -it <nginx-container-name> nginx -s reload

然后再访问那个带参数的URL，应该就能正常加载脚本，不会再提示「Missing parameter」了。

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