Gcloud Kubernetes集群中PhpMyAdmin连接MySQL的问题排查

我来帮你一步步排查这个问题——在K8s里配置数据库和管理工具时，很容易在网络、权限或配置细节上踩坑，咱们逐个梳理：

1. 先确认MySQL是否通过Service暴露给集群内部 #

你只贴了MySQL的Deployment脚本，但Kubernetes里Pod之间的通信必须通过Service实现：PMA的Pod没法直接稳定访问MySQL的Pod（Pod IP会随重建变化），所以首先得给MySQL创建一个ClusterIP Service：

apiVersion: v1
kind: Service
metadata:
  name: mysql-service
spec:
  selector:
    name: mysqldb  # 要和你MySQL Deployment里的Pod标签完全一致
  ports:
    - protocol: TCP
      port: 3306
      targetPort: 3306
  type: ClusterIP  # 默认类型，集群内Pod可直接访问

创建后，PMA配置里的PMA_HOST要填这个Service的名称mysql-service，而不是外部IP——外部IP是用来让你从集群外访问PMA的，不是PMA连接MySQL的地址。

2. 检查MySQL是否允许远程连接 #

默认的MySQL容器只允许localhost访问，你需要在MySQL Deployment里添加环境变量，放开远程连接权限：
修改你的Deployment中spec.template.spec.containers部分，补充环境变量：

containers:
- image: mysql:5.7  # 替换成你实际使用的MySQL镜像版本
  name: mysqldb
  env:
  - name: MYSQL_ROOT_PASSWORD
    value: "你的root密码"  # 必须设置，要和PMA的登录密码一致
  - name: MYSQL_ROOT_HOST
    value: "%"  # 允许任意主机使用root账号连接
  ports:
  - containerPort: 3306
    name: mysqldb

如果用的是自定义MySQL用户，也要确保该用户的主机权限是%（而非localhost）。

3. 验证PhpMyAdmin的核心配置 #

你的PMA部署里，必须正确配置连接MySQL的参数，别搞混了内外网地址：

env:
- name: PMA_HOST
  value: mysql-service  # 填上面创建的MySQL Service名称
- name: PMA_PORT
  value: "3306"
- name: PMA_USER
  value: root  # 或者你创建的自定义MySQL用户
- name: PMA_PASSWORD
  value: "你的MySQL密码"  # 和MySQL设置的密码完全一致，注意大小写和特殊字符

4. 手动测试网络连通性 #

如果配置都对还是连不上，进入PMA的Pod里直接测试连通性：

# 进入PMA Pod
kubectl exec -it <你的PMA Pod名称> -- bash
# 安装telnet工具（如果没有的话）
apt update && apt install -y telnet
# 测试MySQL Service的连通性
telnet mysql-service 3306

如果能连通，说明网络没问题，问题大概率在账号权限或密码；如果连不通，检查Service的selector是否和MySQL Pod的标签匹配，或者有没有NetworkPolicy阻止了3306端口的流量。

5. 查看日志定位具体错误 #

最后可以通过日志找线索：

• 查看MySQL Pod的连接日志，看有没有权限拒绝或连接失败记录：

kubectl logs <你的MySQL Pod名称>

• 查看PMA Pod的日志，看有没有连接报错的具体信息：

kubectl logs <你的PMA Pod名称>

日志里通常会明确给出原因，比如Access denied（密码错误）、Connection refused（网络不通）等。

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