Discuz Docker部署时无法连接数据库怎么办？

Question

在使用 Docker 部署 Discuz 时，常见问题之一是应用容器无法连接到数据库容器。典型表现为安装页面提示“数据库连接失败”。该问题通常由以下原因导致：数据库容器未正常启动、环境变量配置错误（如 DB_HOST、DB_USER、DB_PASSWORD 不匹配）、网络模式未正确配置导致容器间通信受阻，或 MySQL 容器默认使用了非 3306 端口。此外，Docker 网络隔离机制下，若未通过自定义 bridge 网络关联两个容器，也会导致连接超时。需检查 docker-compose.yml 文件中的服务依赖与网络配置，确保 Discuz 容器能正确解析并访问数据库容器的 IP 和端口。

Answer 1

一、问题现象：Discuz 容器提示“数据库连接失败”

在使用 Docker 部署 Discuz 论坛系统时，最常见的问题是应用容器无法成功连接 MySQL 数据库容器。用户在浏览器中访问安装页面时，通常会收到“数据库连接失败”的错误提示。该问题直接影响系统的初始化与运行，是部署流程中的关键阻塞点。

1.1 典型表现

• Discuz 安装向导页面报错：“Can't connect to MySQL server”
• Docker 日志中显示 PHP PDO 或 mysqli 扩展连接超时
• 数据库容器日志提示“Access denied for user”或无监听端口信息
• docker-compose logs discuz 输出频繁重试数据库连接

二、由浅入深的排查路径

2.1 第一层：确认数据库容器是否正常运行

最基础但常被忽略的步骤是检查 MySQL 容器的运行状态。执行以下命令：

docker ps -a | grep mysql

确保容器处于 Up 状态，并查看其启动退出码。若为 Exited，需进一步查看日志：

docker logs <mysql_container_name>

常见问题包括：数据卷权限错误、配置文件语法异常、root 密码为空等导致容器崩溃。

2.2 第二层：验证环境变量配置一致性

Discuz 依赖环境变量传递数据库连接参数。典型的 docker-compose.yml 片段如下：

environment:
  DB_HOST: mysql
  DB_USER: dzuser
  DB_PASSWORD: dzpass123
  DB_NAME: discuzdb

必须确保这些值与 MySQL 容器中实际创建的用户和数据库完全一致。特别注意：

变量名	说明	常见错误
DB_HOST	服务名称（非IP）	误写为 localhost 或 127.0.0.1
DB_USER	需在MySQL中显式授权	未创建用户或主机限制为 %
DB_PASSWORD	区分大小写	特殊字符未转义
MYSQL_ROOT_PASSWORD	MySQL 启动必需	缺失导致容器启动失败

2.3 第三层：Docker 网络通信机制分析

Docker 默认为每个 docker-compose.yml 创建一个自定义 bridge 网络。容器间通过服务名进行 DNS 解析。若未显式定义网络，可能导致跨 compose 项目无法通信。

推荐显式声明网络：

networks:
  backend:
    driver: bridge

services:
  mysql:
    networks:
      - backend
  discuz:
    networks:
      - backend
    depends_on:
      - mysql

可通过进入 Discuz 容器执行 ping 测试：

docker exec -it discuz_container ping mysql

2.4 第四层：端口映射与防火墙策略影响

虽然容器间通信通常走内部网络，但若错误地依赖宿主机 3306 端口，则可能因端口冲突或防火墙拦截而失败。MySQL 容器默认监听 3306，但在某些镜像中可能修改为其他端口（如 3307）。

检查方式：

docker inspect mysql_container | grep HostPort

建议避免暴露 3306 到宿主机，仅在内部网络通信。

三、高级诊断手段与自动化检测流程

3.1 使用 Mermaid 绘制部署拓扑与依赖流

graph TD
            A[Client Browser] --> B[Discuz Web Container]
            B --> C{Can Connect?}
            C -->|Yes| D[Initialize Installation]
            C -->|No| E[Check MySQL Status]
            E --> F[Container Running?]
            F -->|No| G[Start MySQL]
            F -->|Yes| H[Verify Env Variables]
            H --> I[Test Network Reachability]
            I --> J[Ping mysql]
            J --> K[Port 3306 Open?]
            K --> L[Final Connection Test]

3.2 编写健康检查脚本辅助部署

可在 Discuz 启动前加入等待数据库就绪的逻辑：

#!/bin/bash
until mysql -h mysql -u dzuser -p$DB_PASSWORD -e "SELECT 1"; do
  echo "Waiting for MySQL connection..."
  sleep 5
done
php-fpm -D
nginx

3.3 多阶段日志聚合分析

结合 docker-compose logs --tail=50 --follow mysql,discuz 实时监控双端输出，定位时序问题。例如：

• MySQL 初始化耗时超过 30 秒，而 Discuz 在 10 秒内尝试连接
• 字符集不匹配导致连接建立但查询失败
• MySQL 配置 bind-address = 0.0.0.0 未设置，仅监听本地