容器化Express.js REST API连接MariaDB被拒问题求助

核心排查方向与解决方案 #

1. 检查MariaDB用户的访问权限范围 #

本地运行正常但服务器报错，大概率是MariaDB用户的host权限限制：

• 进入MariaDB容器：

  docker exec -it <你的MariaDB容器名> mysql -u root -p
  

• 查看现有用户的允许访问IP：

  SELECT user, host FROM mysql.user;
  

• 如果你的API使用的用户host列是localhost或127.0.0.1，说明该用户仅允许本地（容器内部）访问，无法接受API容器的请求。修改权限：

  -- 生产环境建议指定Docker子网（如172.17.0.0/16）提升安全性，%代表允许任意IP
  GRANT ALL PRIVILEGES ON <你的数据库名>.* TO '<你的用户名>'@'%' IDENTIFIED BY '<你的密码>';
  FLUSH PRIVILEGES;
  

2. 确认Docker容器网络配置 #

API与MariaDB容器必须在同一Docker网络内才能正常通信：

• 查看当前容器所属网络：

  docker inspect <API容器名> | grep Networks
  docker inspect <MariaDB容器名> | grep Networks
  

• 若不在同一网络，创建自定义网络并重启容器：

  docker network create api-db-network
  # 重启MariaDB容器并加入网络
  docker run --name <MariaDB容器名> --network api-db-network -d alpine-mariadb:latest
  # 重启API容器并加入网络
  docker run --name <API容器名> --network api-db-network -d <你的API镜像>
  

• 调整API的数据库连接配置，将host设为MariaDB容器的名称（而非服务器IP），Docker会自动解析容器名到对应IP。

3. 验证MariaDB的bind-address配置 #

确保MariaDB允许外部IP连接：

• 进入MariaDB容器，找到配置文件位置（alpine镜像通常在/etc/my.cnf或/etc/mysql/my.cnf）：

  find / -name my.cnf
  

• 编辑配置文件，修改bind-address为：

  bind-address = 0.0.0.0
  

• 重启MariaDB容器使配置生效：

  docker restart <MariaDB容器名>
  

• 验证端口监听状态：

  docker exec <MariaDB容器名> netstat -tulpn | grep 3306
  

  输出应显示0.0.0.0:3306，表示允许所有IP访问。

4. 排查服务器端环境变量与连接测试 #

• 检查API容器的环境变量是否正确传递：

  docker exec <API容器名> printenv
  

  确认DB_HOST、DB_USER、DB_PASSWORD、DB_NAME无拼写错误或格式问题（比如密码含特殊字符时需用引号包裹）。
• 直接测试数据库连接，排除API代码问题：
  在服务器上用临时容器测试连接：

  docker run --rm mysql:latest mysql -h <MariaDB容器名/服务器IP> -u <你的用户名> -p
  

  若仍报错，说明问题出在数据库配置而非API代码。

5. 检查MariaDB数据卷初始化问题 #

若服务器上的MariaDB容器是全新创建（未挂载本地数据卷），则初始状态下可能没有你本地创建的用户，需重新执行用户创建与授权操作。

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