You need to enable JavaScript to run this app. CentOS 8部署Docker版WordPress出现MySQL数据库连接错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

CentOS 8部署Docker版WordPress出现MySQL数据库连接错误如何解决?

问题根因分析
  • 缺失WORDPRESS_DB_NAME环境变量:当前docker-compose.yaml中WordPress服务的环境变量仅配置了数据库地址、用户名、密码,未明确指定要连接的数据库名称,会触发连接校验失败。
  • 启动顺序逻辑缺陷:depends_on仅控制容器的启动先后顺序,不会等待MySQL服务完成初始化(MySQL容器启动后通常需要5-15秒完成库表、用户创建等初始化操作),提前启动的WordPress发起连接请求会直接失败。
  • CentOS 8防火墙规则冲突:CentOS 8默认使用nftables防火墙框架,低版本Docker未适配该框架会导致自定义桥接网络下的容器间通信被拦截。你在宿主机CLI可以登录MySQL是走的宿主机网络链路,和容器间通信的桥接网络链路独立,因此会出现宿主机可访问、容器连不通的情况。
  • 挂载路径配置错误:官方WordPress镜像的默认站点根目录为/var/www/html,你将本地目录挂载到/var/www/html/example.com子目录,虽然不是数据库连接失败的直接原因,但会导致后续站点访问、代码执行异常。
修复步骤

1. 修正docker-compose.yaml配置

补全缺失配置,增加健康检查保证启动顺序正确:

version: '3.2'
services:
 # Database
 db:
   image: mysql:5.7
   volumes: 
     - mysql_data:/var/lib/mysql # 使用命名卷避免宿主机权限问题
   restart: always
   environment:
     MYSQL_ROOT_PASSWORD: password
     MYSQL_DATABASE: wordpress
     MYSQL_USER: wordpress
     MYSQL_PASSWORD: wordpress
   networks:
     - wpsite
   # 增加MySQL健康检查,确认服务完全就绪
   healthcheck:
     test: ["CMD", "mysqladmin" ,"ping", "-h", "localhost", "-uwordpress", "-pwordpress"]
     timeout: 20s
     retries: 10
 wordpress:
   depends_on:
     db:
       condition: service_healthy # 等待MySQL健康后再启动WordPress
   image: wordpress:latest
   ports:
     - '8000:80'
   restart: always
   volumes:
     # 仅挂载主题插件目录避免覆盖WordPress核心代码,需要全量挂载可改为 ./:/var/www/html
     - ./wp-content:/var/www/html/wp-content
   environment:
     WORDPRESS_DB_HOST: db:3306
     WORDPRESS_DB_USER: wordpress
     WORDPRESS_DB_PASSWORD: wordpress
     WORDPRESS_DB_NAME: wordpress # 补全缺失的数据库名配置
   networks:
     - wpsite
networks:
  wpsite:
volumes:
  mysql_data: # 声明MySQL数据命名卷

2. 修复CentOS 8 Docker网络适配问题

执行以下命令解决防火墙拦截问题:

  • 停止Docker服务:systemctl stop docker
  • 修改Docker配置,兼容CentOS 8防火墙规则:echo '{"iptables": false}' > /etc/docker/daemon.json
  • 重载配置并重启Docker:systemctl daemon-reload && systemctl start docker
  • 可临时关闭防火墙验证:systemctl stop firewalld,如果测试后连接恢复则确认是防火墙规则问题,生产环境建议配置专用Docker网络规则而非直接关闭防火墙。

3. 清空残留数据重新启动

避免之前的错误初始化数据干扰:

docker-compose down -v # 注意:-v会删除关联卷,如有旧数据请先备份
docker-compose up -d

4. 验证连通性

启动完成后进入WordPress容器验证数据库连接:

# 替换为实际的WordPress容器名,可通过docker ps查看
docker exec -it <wordpress容器名> bash
# 容器内执行以下命令,能正常进入MySQL命令行则说明连接正常
apt update && apt install -y default-mysql-client
mysql -h db -uwordpress -pwordpress wordpress

如果仍有问题,可通过docker logs <mysql容器名>、docker logs <wordpress容器名>查看具体错误日志进一步定位。

内容的提问来源于stack exchange,提问作者Lee Dat

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 05:06:03