在使用 Laravel Sail 进行开发和部署时，遇到 MySQL 连接不上的问题

在使用 Laravel Sail 进行开发和部署时，有时会遇到 MySQL 连接不上的问题。这种问题通常出现在使用 Laravel Sail 的情况下。本文将详细解释遇到该问题的原因以及如何解决。

阅读更多：MySQL 教程

原因分析

Laravel Sail 是一个由 Docker 提供支持的 Laravel 开发环境。在本地开发时， Laravel Sail 会启动一个本地 Docker 容器来运行应用程序。该容器包括一个 MYSQL 实例。因此，在开始 Laravel Sail 开发时，应该确保 MySQL 安装和 Laravel Sail 启动都没有问题。

在 Laravel Sail 进行开发和部署时，常见的错误是 “Can’t connect to MySQL”。这个问题通常是由以下几个原因导致的：

1. WEB 服务和数据服务没有启动

使用 Laravel Sail 自带的 Web 服务器时，我们需要运行以下命令：

./vendor/bin/sail up

这个命令会启动 Laravel Sail 的所有服务，包括 PHP、MySQL、Redis 和 Mailhog 等服务。当我们使用 MySQL 服务时，必须保证 Laravel Sail 的 MySQL 服务已经在运行。

2. 数据库服务端口冲突

在使用 MySQL 服务时，我们需要保证 Laravel Sail 的 MySQL 容器的端口没有被占用。假设在本地已经有一个 MySQL 服务在运行，默认端口是 3306。如果 Laravel Sail 的 MySQL 容器在运行时使用的也是 3306 端口，那么这两个服务将会出现端口冲突。

我们可以通过修改 Laravel Sail 的 MySQL 容器端口来避免这个问题。在项目根目录下，找到 sail.yml 文件，然后添加以下内容：

services:
    mysql:
        ports:
            - "3307:3306"

这样的设置将会把 Laravel Sail 的 MySQL 服务端口从默认的 3306 端口修改为 3307 端口，避免与已经运行的 MySQL 服务端口有冲突。

3. 数据库访问权限冲突

在 Laravel Sail 中，数据库用户名默认为 root ，密码默认为空。如果我们在运行 Laravel Sail 时提供了另一个数据库名或密码，那么 Laravel Sail 可能会出现访问数据库的权限错误。

我们应该确保 Laravel Sail 的 MySQL 容器始终使用静态的用户名和密码，避免发生权限冲突。首先，在项目根目录下，找到 .env 文件，然后添加以下内容：

DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=mydb
DB_USERNAME=root
DB_PASSWORD=

这里， DB_HOST 的值必须是 docker-compose.yml 中的服务名，这里为 mysql。这样就可以与 Laravel Sail 的 MySQL 服务建立连接，确保在进行开发时没有访问权限错误。

4. 在 Laravel 配置文件中错误指定数据库

在进行 Laravel 开发时，通常我们会在 .env 配置文件中配置数据库连接信息，如下所示：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=mydatabase
DB_USERNAME=root
DB_PASSWORD=password

在 Laravel Sail 开发中，由于数据库在容器中运行，我们应该在 .env 文件中使用 Laravel Sail 默认的数据库连接设置，因为这些设置已经指向了 Laravel Sail MySQL 容器提供的数据库服务。

解决方法

遇到 Laravel Sail 连接不上 MySQL 服务的问题时，我们可以采取以下几种解决方法：

1. 确认 Laravel Sail 的 MySQL 服务已经启动

使用以下命令来启动 Laravel Sail 的所有服务：

./vendor/bin/sail up

2. 确认 Laravel Sail 的 MySQL 服务端口没有被使用

可以通过检查配置文件中端口号是否与已有的 MySQL 服务冲突来确认 MySQL 服务是否可用。如果有冲突，需要修改端口号。修改方法：

在项目根目录下，找到 sail.yml 文件，找到以下内容：

services:
    mysql:
        ports:
            - "3306:3306"

将 “3306:3306” 修改为 “3307:3306″，再执行以下命令启动服务：

./vendor/bin/sail up -d

3. 确认数据库访问权限正确

我们需要确保 Laravel Sail 的 MySQL 容器始终使用静态的用户名和密码来连接数据库，避免发生访问权限冲突。

在 .env 文件中，需要设置如下配置：

DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=mydb
DB_USERNAME=root
DB_PASSWORD=

其中， DB_HOST 的值必须为 mysql，因为这与 Laravel Sail 的 MySQL 服务的名称一致。

4. 检查 Laravel 配置文件是否正确设置

在 Laravel 开发中，我们通常会在配置文件中指定数据库连接信息，如下示例所示：

...
'default' => env('DB_CONNECTION', 'mysql'),

'connections' => [

    'mysql' => [
        'driver' => 'mysql',
        'url' => env('DATABASE_URL'),
        'host' => env('DB_HOST', '127.0.0.1'),
        'port' => env('DB_PORT', '3306'),
        'database' => env('DB_DATABASE', 'forge'),
        'username' => env('DB_USERNAME', 'forge'),
        'password' => env('DB_PASSWORD', ''),
        'unix_socket' => env('DB_SOCKET', ''),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'prefix_indexes' => true,
        'strict' => true,
        'engine' => null,
        'options' => extension_loaded('pdo_mysql') ? array_filter([
            PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
        ]) : [],
    ],
...

在 Laravel Sail 中，此文件应该如下修改：

...
'default' => env('DB_CONNECTION', 'sail'),

'connections' => [

    'sail' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST', 'mysql'),
        'port' => env('DB_PORT', '3306'),
        'database' => env('DB_DATABASE', 'sail'),
        'username' => env('DB_USERNAME', 'root'),
        'password' => env('DB_PASSWORD', ''),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'prefix_indexes' => true,
        'strict' => true,
        'engine' => null,
    ],
...

在执行修改后，需要重启 Laravel Sail 的全部服务：

sail down && sail up -d

一般情况下，以上操作就可以解决由于 MySQL 服务无法连接而导致的报错问题。

总结

在 Laravel Sail 的开发中，MySQL 连接错误往往是由配置问题或者服务启动问题导致的。我们可以通过检查 Laravel Sail 的 MySQL 服务是否正确启动来解决问题，同时需要确认 Laravel Sail 的 MySQL 服务端口没有被使用，数据库访问权限正确，以及 Laravel 配置文件中是否正确设置。如果以上检查都没有问题，那么我们可以考虑重启服务来解决问题。