Docker-Compose部署PrestaShop后无法连接MySQL数据库求助

以下是几种常见原因及对应的解决办法：

1. MySQL 容器初始化未完成 #

容器显示"正常启动"仅代表容器进程运行，MySQL内部还在执行数据库初始化、用户创建等操作，此时手动连接会失败（PrestaShop容器通常内置重试机制，所以能正常运行）。

• 解决：等待2-3分钟后再尝试连接；或在自定义连接脚本中加入重试逻辑，比如循环执行连接命令直到成功。

2. MySQL 用户权限限制 #

默认生成的prestashop用户可能仅允许localhost访问，而PrestaShop容器通过容器网络以主机名db访问，属于远程连接范畴，权限不足导致失败。

• 解决：
  1. 进入MySQL容器：docker exec -it <db-container-name> mysql -uroot -p（输入docker-compose中配置的root密码）
  2. 执行权限授权命令：

     GRANT ALL PRIVILEGES ON prestashop.* TO 'prestashop'@'%' IDENTIFIED BY 'prestashop';
     FLUSH PRIVILEGES;
     

  3. 也可以在docker-compose.yml中挂载初始化SQL脚本，提前创建允许所有主机访问的用户。

3. 容器网络配置异常 #

如果两个容器不在同一个Docker自定义网络中，db主机名无法被解析。虽然docker-compose默认会为所有服务创建并加入同一个网络，但手动修改网络配置可能导致异常。

• 解决：
  1. 检查docker-compose.yml，确认两个服务未指定不同的自定义网络；
  2. 执行docker inspect <prestashop-container-id>和docker inspect <db-container-id>，查看Networks字段是否一致；
  3. 临时测试：用db容器的IP地址替代db主机名，执行docker inspect db | grep IPAddress获取IP后尝试连接。

4. MySQL 绑定地址限制 #

若自定义了MySQL配置文件（如my.cnf），将bind-address设置为127.0.0.1会导致仅允许容器内部本地连接，拒绝外部（包括其他容器）的连接请求。

• 解决：
  1. 检查挂载的my.cnf文件，将bind-address修改为0.0.0.0；
  2. 若无需自定义配置，删除挂载的配置文件，使用官方MySQL镜像默认配置。

5. 宿主机连接的端口映射问题 #

如果是在宿主机上使用数据库工具连接，直接用db作为主机名无效（宿主机无法解析容器内部的主机名），需先映射MySQL端口到宿主机。

• 解决：
  1. 在docker-compose.yml的db服务中添加端口映射：

     services:
       db:
         ports:
           - "3306:3306"
     

  2. 重启容器后，在宿主机上使用localhost或127.0.0.1作为服务器地址，搭配配置的用户名、密码和数据库名连接。

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