Cloudways部署Laravel：安装phpMyAdmin后出现404错误求助

核心原因 #

Laravel默认的URL重写规则会将所有请求转发到index.php，导致/phpmyadmin路径被Laravel路由系统拦截，返回404错误。需要配置服务器让/phpmyadmin请求直接指向phpMyAdmin的安装目录，绕过Laravel。

具体解决步骤 #

1. 确认phpMyAdmin的实际安装路径 #

登录Cloudways服务器终端，执行命令查找phpMyAdmin的安装目录（通常位于项目public目录外，格式类似/home/master/applications/[你的应用名]/phpmyadmin）：

find /home/master/applications -name phpmyadmin -type d

2. 修改Nginx配置（Cloudways默认使用Nginx） #

• 进入Cloudways控制面板，找到目标应用，点击Application Settings > Custom Nginx Config
• 在Server Block区域添加以下规则（将[phpmyadmin实际路径]替换为第一步查到的路径，[你的PHP版本]替换为应用使用的PHP版本，比如php8.1）：

location /phpmyadmin {
    root [phpmyadmin实际路径]/../;
    index index.php index.html index.htm;

    location ~ ^/phpmyadmin/(.+\.php)$ {
        root [phpmyadmin实际路径]/../;
        fastcgi_pass unix:/run/php/[你的PHP版本]-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

• 点击Save Changes，然后重启Nginx服务（可在控制面板操作，或终端执行sudo service nginx restart）

3. 验证配置有效性 #

清除浏览器缓存后重新访问/phpmyadmin，若仍有问题，检查：

• phpMyAdmin路径是否填写正确
• Nginx配置中的PHP版本sock文件路径是否匹配应用实际版本
• phpMyAdmin目录权限是否设置为755，文件权限为644

备选方案：Apache环境下修改.htaccess #

若应用使用Apache，在项目public目录的.htaccess文件开头添加以下规则，让Apache直接处理/phpmyadmin请求：

RewriteRule ^phpmyadmin - [L]

保存后重启Apache服务即可。

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