Docker环境下Linkedin WhereHows后端无法连接MySQL求助（Web端正常）

既然Web端能正常连接MySQL，但后端容器却连不上，而且你已经确认IP、用户名密码都正确，那问题大概率出在容器网络配置或者后端配置文件的细节疏漏上，咱们一步步排查解决：

1. 先确认后端容器和MySQL的网络连通性 #

Web能连说明数据库本身没问题，先排查网络隔离：

• 进入后端容器：docker exec -it <your-backend-container-id> /bin/bash
• 尝试ping MySQL容器的IP：ping <mysql-container-ip>
  • 如果ping不通，说明两个容器不在同一个Docker网络里。如果是用Docker Compose部署的，检查配置里是否给所有容器指定了同一个自定义网络；如果是手动启动的容器，重启后端时要加入MySQL所在的网络：docker run --network <mysql-network-name> wherehows/backend
• 更稳妥的方式是用容器名ping，比如MySQL容器叫wherehows-mysql，试试ping wherehows-mysql，如果能通，建议直接在后端配置里用容器名代替IP，避免容器重启后IP变动的问题。

2. 仔细核对后端配置文件的连接参数 #

打开/backend-service/conf/application.conf，检查几个容易踩坑的细节：

• JDBC URL格式是否规范：要确保包含端口、关闭不必要的SSL（如果MySQL容器没开启SSL的话），正确格式示例：

  db.default.url="jdbc:mysql://<mysql-host>:3306/wherehows?useSSL=false&serverTimezone=UTC&characterEncoding=utf8"
  

  这里的<mysql-host>可以是MySQL容器的IP或者容器名
• 驱动类是否匹配MySQL版本：如果是MySQL 8.x，驱动类是com.mysql.cj.jdbc.Driver；旧版本是com.mysql.jdbc.Driver，别写错
• 特殊字符转义：如果密码里有@、&这类特殊字符，必须做URL编码，比如密码是pass&word，要写成pass%26word

3. 验证MySQL用户的访问权限 #

虽然你说用户名密码正确，但还是要确认该用户允许从后端容器的IP段访问：

• 进入MySQL容器：docker exec -it <mysql-container-id> mysql -u root -p
• 查询用户权限：

  SELECT host, user FROM mysql.user;
  

  如果你的后端用户的host是localhost或者特定IP，会被容器网络的IP拦截，改成%允许所有IP访问：

  GRANT ALL PRIVILEGES ON wherehows.* TO 'your-wherehows-user'@'%' IDENTIFIED BY 'your-password';
  FLUSH PRIVILEGES;
  

4. 查看后端容器的错误日志 #

最后一定要看后端的日志，里面有最直接的报错信息：

• 查看日志命令：docker logs <your-backend-container-id>
  比如日志显示Connection timed out就是网络问题；Access denied可能是配置里的用户名密码写错了；Unknown database要确认wherehows数据库是否已经创建。

我之前遇到过几乎一模一样的问题，就是后端容器没加入MySQL所在的自定义网络，调整网络配置后立刻就连上了，你可以先从这一步排查。

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