如何修复phpMyAdmin在Nginx下点击导航栏跳转404的问题？-phpMyAdmin-PHP中文网

根本原因是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（或你的部署路径），确认没有这行：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

/* 禁用此项，否则它会拒绝处理 PATH_INFO */
$cfg['AllowArbitraryServer'] = false;

同时检查：

$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 路径拼接问题