Laravel数据库无法找到求助：双MySQL/Apache环境配置异常

一、解决双Apache/MySQL端口冲突问题 #

系统内两个Apache（默认端口80）、两个MySQL（默认端口3306）会因端口占用冲突，不用每次手动停止系统服务，可通过以下两种方式解决：

• 修改XAMPP服务端口，规避冲突

  1. Apache端口调整：打开XAMPP控制面板，点击Apache的Config -> Apache (httpd.conf)，将Listen 80改为Listen 8080，ServerName localhost:80改为ServerName localhost:8080；再打开httpd-ssl.conf，把Listen 443改为Listen 4433，<VirtualHost _default_:443>改为<VirtualHost _default_:4433>。
  2. MySQL端口调整：点击XAMPP控制面板中MySQL的Config -> my.cnf，将port=3306改为port=3307（或其他未被占用的端口）。
     修改后重启XAMPP，后续无需停止系统服务，直接通过对应端口访问XAMPP服务即可。

• 禁用系统服务开机自启（若无需系统自带的Apache2和MySQL）
  执行以下命令关闭开机自动运行：

  sudo systemctl disable apache2
  sudo systemctl disable mysql
  

二、解决Laravel数据库在XAMPP中不显示、提示“unknown”的问题 #

仅修改.env端口无效，可从以下几点排查：

• 确认.env数据库配置完全匹配XAMPP的MySQL
  打开Laravel项目根目录的.env文件，确保配置项正确：

  DB_CONNECTION=mysql
  DB_HOST=127.0.0.1
  DB_PORT=3306  # 若修改了XAMPP的MySQL端口，此处需同步修改（如3307）
  DB_DATABASE=你的数据库名称
  DB_USERNAME=root  # XAMPP默认MySQL用户为root，默认无密码
  DB_PASSWORD=
  

  修改后需清除Laravel配置缓存：

  php artisan config:clear
  php artisan cache:clear
  

• 验证XAMPP的MySQL中是否存在目标数据库
  访问XAMPP的phpMyAdmin（如http://localhost:8080/phpmyadmin，需匹配修改后的Apache端口），查看左侧数据库列表，确认Laravel数据库是否存在。若不存在，可手动创建，或执行迁移命令：

  php artisan migrate
  

• 检查数据库权限
  确保XAMPP的MySQL用户（默认root）拥有目标数据库的访问权限，可在phpMyAdmin中给root用户赋予全局权限，或执行SQL语句：

  GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost';
  FLUSH PRIVILEGES;
  

• 测试Laravel数据库连接
  在routes/web.php中添加测试路由，验证连接详情：

  Route::get('/test-db', function () {
      try {
          DB::connection()->getPdo();
          return "数据库连接成功！当前数据库：" . DB::connection()->getDatabaseName();
      } catch (\Exception $e) {
          return "连接失败：" . $e->getMessage();
      }
  });
  

  访问该路由，根据返回信息定位具体问题。

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