Laravel Docker容器化时部分模块报MySQL解析错误求助

1. 核对Docker Compose中MySQL服务名称 #

检查docker-compose.yml里MySQL服务的服务键名（services下的一级键）或container_name是否为purolink_mysql_server。Docker Compose默认以服务名作为容器间的DNS别名，示例配置如下：

services:
  purolink_mysql_server:  # 此处名称必须与Laravel配置中的DB_HOST一致
    image: mysql:8.0
    # 其余配置项...

如果服务名不匹配，要么修改Docker Compose的服务名，要么调整Laravel的数据库连接配置。

2. 检查Laravel数据库环境变量 #

确认容器内.env文件的DB_HOST值是否为purolink_mysql_server：

DB_HOST=purolink_mysql_server
DB_PORT=3306
DB_DATABASE=你的数据库名
DB_USERNAME=你的数据库账号
DB_PASSWORD=你的数据库密码

注意：Docker容器内不能用localhost或127.0.0.1作为数据库地址，否则会指向容器自身而非MySQL容器。

3. 验证容器间网络连通性 #

进入Laravel应用容器，尝试ping MySQL服务名，测试DNS解析是否正常：

# 替换为你的Laravel容器名称
docker exec -it 你的laravel容器名 ping purolink_mysql_server

如果ping不通，需检查：

• 两个容器是否在同一Docker网络中？Docker Compose默认会为项目创建专属网络，所有服务默认加入该网络，除非手动指定其他网络。
• 查看网络列表：docker network ls，查看MySQL容器所属网络：docker inspect purolink_mysql_server | grep Network

4. 确认MySQL容器状态 #

检查MySQL容器是否正常启动且无初始化错误：

docker-compose ps purolink_mysql_server
# 查看MySQL容器日志
docker-compose logs purolink_mysql_server

若MySQL容器未启动或初始化失败，也会导致连接报错。

5. 清理Laravel配置缓存 #

如果之前在容器内执行过php artisan config:cache，修改.env后需清理缓存：

docker exec -it 你的laravel容器名 php artisan config:clear
docker exec -it 你的laravel容器名 php artisan cache:clear

预发布/生产环境可能未启用配置缓存，或配置本身正确，因此无此问题。

6. 排查特定模块的独立数据库连接 #

部分模块可能使用了自定义数据库连接（在config/database.php中新增的连接），需检查这些连接的host配置是否指向正确的服务名：

'custom_module_connection' => [
    'driver' => 'mysql',
    'host' => env('DB_MODULE_HOST', 'purolink_mysql_server'),
    // 其余配置项...
],

若该模块使用独立连接且DB_MODULE_HOST配置错误，会出现仅该模块报错的情况。

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