根本原因是Nginx未配置PATH_INFO解析及精确的PHP路由匹配,必须用location ~ ^/phpmyadmin/(.+.php)$块配合fastcgi_split_path_info和SCRIPT_FILENAME绝对路径,否则/phpmyadmin/database/structure/等路径无法被正确路由到index.php处理。
为什么 phpMyAdmin 在 Nginx 下点击“数据库”或“用户”会 404?
根本原因是 nginx 默认不处理 phpmyadmin 的内部 url 重写逻辑(比如 /phpmyadmin/db_structure.php?db=test 这类带 query string 的请求没问题,但点击导航栏时前端可能触发类似 /phpmyadmin/database/structure/?db=test 这样的 path_info 风格路由),而 apache 的 .htaccess 会自动 fallback 到 index.php,nginx 没这机制,必须显式配置。
必须添加 location ~ ^/phpmyadmin/(.*\.php)$ 的精确匹配
很多人只配了 location /phpmyadmin/,但这会把所有子路径(包括静态资源和伪静态路由)都扔给 PHP-FPM,导致 CSS/JS 加载失败或路由解析错乱。正确做法是分离处理:
-
location /phpmyadmin/:只负责静态文件(CSS、JS、图片),加try_files $uri =404; -
location ~ ^/phpmyadmin/(.*\.php)$:专门捕获 PHP 脚本,确保 PATH_INFO 正确传递 - 关键:在该 location 块中必须设置
fastcgi_split_path_info ^(.+\.php)(/.+)$;和fastcgi_param PATH_INFO $fastcgi_path_info;,否则 phpMyAdmin 无法识别/database/structure/这类路径段
fastcgi_param SCRIPT_FILENAME 必须用绝对路径
常见错误是写成 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;,但当请求是 /phpmyadmin/database/structure/ 时,$fastcgi_script_name 可能变成 /phpmyadmin/database/structure/(非 .php 文件),导致 404。解决方案:
- 用
fastcgi_param SCRIPT_FILENAME /usr/share/phpmyadmin/$fastcgi_script_name;(路径按实际安装位置调整) - 或者更稳妥:结合
alias指令,在location /phpmyadmin/块里用alias /usr/share/phpmyadmin/;,再在 PHP location 中用fastcgi_param SCRIPT_FILENAME $request_filename; - 漏掉
fastcgi_param PHP_ADMIN_VALUE "open_basedir=/usr/share/phpmyadmin/:/tmp/";可能导致部分功能(如导入)报错,建议加上
检查 phpMyAdmin 的配置文件是否禁用了 Rewrite
虽然 Nginx 不读 .htaccess,但 phpMyAdmin 自身会检测 Web 服务器类型并调整行为。打开 /usr/share/phpmyadmin/config.inc.php(或你的部署路径),确认没有这行:
/* 禁用此项,否则它会拒绝处理 PATH_INFO */ $cfg['AllowArbitraryServer'] = false;
同时检查:
立即学习“PHP免费学习笔记(深入)”;
-
$cfg['PmaAbsoluteUri']是否与 Nginx 的location前缀一致(例如设为https://example.com/phpmyadmin/) - 如果用了子目录部署(如
/tools/pma/),必须同步修改 Nginx 的location、alias和$cfg['PmaAbsoluteUri'],三者不一致必出 404 - 浏览器控制台若报
Failed to load resource: the server responded with a status of 404 ()且路径形如/phpmyadmin/js/jquery/jquery.min.js,说明静态文件 location 没生效,优先查alias或root路径拼接问题
Nginx 对路径的字面匹配非常严格,少一个斜杠、多一个正则锚点、PATH_INFO 传空,都会让 phpMyAdmin 的前端路由彻底失效——这不是代码 bug,是配置没对齐它的运行假设。



















