Kubernetes中Tomcat容器无法连接MySQL容器问题排查求助

我来帮你一步步捋清楚这个问题，先从YAML配置的核心要点查起，再给你一些实操的排查步骤：

一、先检查你的YAML配置关键点 #

MySQL相关配置检查 #

• Service与Deployment的标签匹配：一定要确认mysql-service.yaml里的spec.selector和mysql-deployment.yaml中spec.template.metadata.labels完全一致。比如如果Deployment的Pod标签是app: mysql，Service的selector也得是app: mysql——这是K8s内部服务发现的核心，标签不匹配的话Tomcat根本找不到MySQL服务。
• MySQL Deployment的环境变量：检查mysql-deployment.yaml里是否正确设置了MYSQL_ROOT_PASSWORD、MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD这些初始化参数，Tomcat里的连接配置必须和这些参数完全对应。
• PV/PVC挂载路径：MySQL默认的数据存储目录是/var/lib/mysql，如果你的PVC挂载到了其他路径，会导致数据库初始化失败，Pod启动不起来。
• Service类型：MySQL Service用默认的ClusterIP就够了，不需要NodePort，因为它只需要集群内部访问。

Tomcat相关配置检查 #

• 数据库连接环境变量：确认Tomcat Deployment里的数据库连接参数用的是MySQL Service的名称（比如DB_HOST: mysql-service），而不是固定IP——K8s的Service会自动解析这个服务名为集群内部的IP。同时要核对DB_PORT=3306、DB_NAME、DB_USER、DB_PASSWORD和MySQL的环境变量完全一致。
• Pod资源限制：如果Tomcat Pod分配的CPU/内存太少，可能会导致war包启动时内存不足失败。可以在Tomcat-Deployment.yaml的spec.containers.resources里增加合理的请求和限制，比如：

  resources:
    requests:
      cpu: "500m"
      memory: "1Gi"
    limits:
      cpu: "1"
      memory: "2Gi"
  

• PV/PVC挂载冲突：你已经通过Dockerfile把war包拷到了/usr/local/tomcat/webapps，如果Tomcat Deployment里把PVC挂载到了这个目录，会把镜像里的war包覆盖掉，导致找不到应用。如果需要持久化Tomcat的日志等目录，应该挂载到/usr/local/tomcat/logs而不是webapps。

二、实操排查步骤 #

1. 检查Pod状态：先执行kubectl get pods，确认MySQL和Tomcat的Pod都是Running状态。如果MySQL Pod是CrashLoopBackOff，立刻看日志找原因：

   kubectl logs <mysql-pod-name>
   

   常见问题是密码不符合MySQL的复杂度要求，或者PV权限不足。

2. 查看Tomcat启动日志：如果Tomcat Pod是Running但应用启动失败，直接看Tomcat的核心日志：

   kubectl exec -it <tomcat-pod-name> -- tail -f /usr/local/tomcat/logs/catalina.out
   

   这里会显示war包启动的具体错误，比如数据库连接超时、用户名密码错误、依赖缺失等，这是最关键的排查信息。

3. 测试连通性：进入Tomcat Pod，直接测试到MySQL Service的连通性：

   kubectl exec -it <tomcat-pod-name> -- telnet mysql-service 3306
   # 或者用nc，如果telnet没装的话
   kubectl exec -it <tomcat-pod-name> -- nc -zv mysql-service 3306
   

   如果连不通，说明Service配置有问题（标签不匹配）或者集群网络插件异常。

4. 检查Tomcat管理控制台：如果能访问Tomcat的管理页面（默认路径/manager/html），登录后查看应用的状态，里面会显示启动失败的具体原因，比日志更直观。

三、常见问题的修复方案 #

• 数据库连接超时：确认MySQL Service的名称正确，且MySQL Pod正常运行；如果是网络插件问题，重启一下集群的网络组件（比如Calico、Flannel）。
• war包未自动解压：picoded/tomcat7默认应该开启了自动部署，但如果没生效，可以手动进入Pod解压：

  kubectl exec -it <tomcat-pod-name> -- unzip /usr/local/tomcat/webapps/data-core-0.0.1-SNAPSHOT.war -d /usr/local/tomcat/webapps/data-core-0.0.1-SNAPSHOT
  

• 权限问题：如果PV挂载后Tomcat没有读写权限，可以在Tomcat Deployment的Pod模板里添加安全上下文：

  securityContext:
    runAsUser: 1000
    fsGroup: 1000
  

  这会让Pod以普通用户身份运行，同时赋予组对挂载目录的读写权限。

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