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
相关产品推荐
相关产品推荐

