Docker中MySQL数据库访问被拒绝问题及docker-compose.yml配置

咱们一步步拆解可能的问题，从基础配置到容器间连通性，逐个排查：

1. 先补全MariaDB容器的核心配置 #

你贴的docker-compose里只包含了PHP应用容器，没看到mysql和mysql_test这两个MariaDB容器的配置——这部分是关键！先确保它们的配置满足以下要求：

• 必须设置MARIADB_ROOT_PASSWORD（或MYSQL_ROOT_PASSWORD，取决于镜像版本），否则数据库初始化会直接失败，拒绝所有连接
• 如果给应用用非root用户，要通过环境变量提前创建数据库和授权用户，比如MARIADB_DATABASE、MARIADB_USER、MARIADB_PASSWORD
• 示例MariaDB配置片段：

mysql:
  container_name: mysql
  image: mariadb:latest
  environment:
    MARIADB_ROOT_PASSWORD: your_secure_root_pass
    MARIADB_DATABASE: app_db
    MARIADB_USER: app_user
    MARIADB_PASSWORD: app_user_pass
  volumes:
    - mysql_data:/var/lib/mysql  # 持久化数据，避免重启后丢失数据

2. 排查容器间的网络与连通性 #

虽然你用了links和depends_on，但要注意两个关键点：

• depends_on只保证容器启动顺序，不保证MariaDB服务完全就绪（数据库第一次初始化需要加载数据，耗时比应用容器长）
• 应用里的数据库主机名必须写容器名（比如mysql或mysql_test），Docker的links会自动把这些主机名解析到对应容器的IP

可以进入app容器手动测试连通性：

• 先ping容器：ping mysql，看是否能解析到IP并连通
• 再测端口：telnet mysql 3306或nc -zv mysql 3306，确认3306端口是否开放

3. 解决数据库用户的权限坑 #

这是最常见的访问拒绝原因：

• 默认情况下，MariaDB的root用户只能从localhost访问，如果你在应用里用root连接，需要授权允许远程访问：

  GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'your_root_pass' WITH GRANT OPTION;
  FLUSH PRIVILEGES;
  

• 如果你用自定义用户（比如上面的app_user），要确保授权时允许从容器所在的网络段访问，直接用%允许任意主机在容器环境下是安全的
• 尽量避免在应用里用root用户，专用数据库用户更安全

4. 让应用等待数据库完全就绪 #

因为depends_on不等待服务就绪，你可以给应用容器加一个等待逻辑：

• 把wait-for-it.sh脚本打包进你的php-apache-dev镜像，或者挂载到容器里
• 修改app容器的启动命令，等待数据库端口开放后再启动服务：

app:
  # ... 其他配置
  command: ["./wait-for-it.sh", "mysql:3306", "--", "apache2-foreground"]

这个脚本会循环检测数据库端口，直到连通再执行后面的Apache启动命令

5. 检查Docker网络与防火墙 #

• 推荐用自定义网络替代links（links是旧特性），确保所有相关容器都加入同一个网络：

version: '2'
networks:
  app-network:
    driver: bridge

services:
  app:
    # ... 其他配置
    networks:
      - app-network
  mysql:
    # ... 其他配置
    networks:
      - app-network

• 确认宿主机防火墙没有拦截容器间的桥接网络流量（Docker默认允许容器间通信）

6. 通过日志定位具体错误 #

• 查看MariaDB容器日志：docker logs mysql，找初始化错误、权限问题或端口占用信息
• 查看app容器日志：docker logs app，看PHP连接数据库时的具体报错（比如是用户名密码错误、主机不可达，还是权限不足）

按照上面的步骤排查，基本能定位到问题所在——比如是数据库未就绪就连接，加等待脚本就能解决；如果是权限问题，调整授权语句即可。

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