如何在Ubuntu中解决Nginx访问phpMyAdmin报404错误-phpMyAdmin-PHP中文网

ubuntu默认apt安装的phpmyadmin位于/usr/share/phpmyadmin，不会自动创建web根目录软链接；nginx需用alias /usr/share/phpmyadmin/（末尾斜杠不可省）并配置fastcgi_param script_filename $request_filename，同时确保php-fpm运行、权限正确且无浏览器缓存干扰。

如何在ubuntu中解决nginx访问phpmyadmin报404错误

确认phpMyAdmin是否真的安装在Nginx可访问路径下

Ubuntu默认用apt安装的phpmyadmin包，**不会自动创建/usr/share/phpmyadmin到Web根目录的符号链接**，这是404最常见原因。Nginx配置里写的alias或root路径如果指向一个不存在的路径，就直接返回404，连PHP解析都不会触发。

执行以下命令验证实际安装位置和链接状态：

ls -l /usr/share/phpmyadmin
ls -l /var/www/html/phpmyadmin

如果/var/www/html/phpmyadmin是断链或根本不存在，说明链接没建。此时不要手动复制文件——容易权限/更新问题，应使用dpkg-reconfigure重建：

运行sudo dpkg-reconfigure phpmyadmin
过程中务必勾选nginx（不是apache2），并确认“是”让安装程序自动配置Web服务器
若提示选择Web路径别名，建议保留默认/phpmyadmin，避免后续配置不一致

Nginx配置中alias和root的误用导致路径解析失败

很多人直接抄网上配置，在location /phpmyadmin块里写root /usr/share，结果Nginx会拼出/usr/share/phpmyadmin/phpmyadmin——多了一层，必然404。正确做法是用alias，且末尾必须带/：

location /phpmyadmin {
    alias /usr/share/phpmyadmin/;
    index index.php;
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;  # 注意PHP版本号匹配
        fastcgi_param SCRIPT_FILENAME $request_filename;
    }
}

关键点：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

alias值末尾的/不能省，否则$request_filename会少一层路径
fastcgi_param SCRIPT_FILENAME $request_filename必须显式设置，因为alias下$document_root不可靠
检查fastcgi_pass路径是否与系统实际PHP-FPM套接字一致：ls /run/php/看真实文件名，Ubuntu 22.04常用php8.1-fpm.sock，24.04可能已是php8.3-fpm.sock

PHP-FPM未启用或用户权限不匹配

即使Nginx配置全对，如果PHP-FPM服务没运行，或者Nginx worker进程用户（通常是www-data）无法读取/usr/share/phpmyadmin里的文件，也会静默返回404（而非502/500）。先确认基础服务状态：

sudo systemctl status php8.1-fpm  # 替换为你的PHP版本
sudo nginx -t  # 检查Nginx配置语法
sudo systemctl reload nginx

再检查权限：

/usr/share/phpmyadmin目录需对www-data组可读：sudo chmod -R g+r /usr/share/phpmyadmin
确保www-data属于www-data组：groups www-data，若无输出则运行sudo usermod -a -G www-data www-data
若仍不行，临时测试：在/var/www/html下建软链sudo ln -s /usr/share/phpmyadmin /var/www/html/phpmyadmin，然后改Nginx配置为root /var/www/html + location /phpmyadmin内用index和try_files，排除路径映射干扰

浏览器缓存或URL路径拼写错误被忽略

开发时反复试错容易忽略最表层的问题：你访问的真的是http://your-server-ip/phpmyadmin吗？还是/phpMyAdmin（大小写）、/phpmyadmin/（结尾斜杠）、或加了index.php？Nginx默认不处理大小写重定向，phpMyAdmin ≠ phpmyadmin。

同时，Chrome/Firefox对404响应缓存较强，尤其当你之前配错又改对后，页面仍显示旧404。强制刷新方法：