使用Minikube部署Drupal站点时数据库连接故障排查
核心配置错误排查
以下为直接导致Drupal无法连接数据库的硬配置问题,无网络/权限类玄学因素:
- 致命选择器错配:MySQL Service未关联到实际MySQL Pod
drupal-mysql.yaml中定义的drupal-mysql-service,selector配置为app: drupal,但MySQL Deployment创建的Pod实际标签为app: mysql。
该错配会导致Service后端无匹配的Endpoints,所有指向drupal-mysql-service的3306端口流量完全无法路由到运行MySQL的Pod。可通过命令直接验证:
kubectl get endpoints drupal-mysql-service,若输出的ENDPOINTS列为空,即可坐实该问题。 - 冗余非法配置:Drupal Pod模板存在无效字段
drupal.yaml的Pod模板spec层级下,多写了无值的selector:字段,K8s Pod资源的schema中不存在该字段,虽多数版本会自动忽略,但会增加配置解析异常风险。
修复操作
- 修正MySQL Service的选择规则
把drupal-mysql.yaml中Service段的selector配置替换为匹配MySQL Pod标签的内容:
执行spec: selector: app: mysqlkubectl apply -f drupal-mysql.yaml使配置生效。 - 清理无效配置
删掉drupal.yaml中Pod模板spec下多余的空selector:行,重新apply让Drupal资源配置正常加载。
连通性验证流程
- 确认Service路由正常:执行
kubectl get endpoints drupal-mysql-service,确保输出中存在<MySQL Pod IP>:3306的条目,无空值。 - 从Drupal容器内测试网络通路:
- 先执行
kubectl get pods获取Drupal Pod的完整名称 - 执行
kubectl exec -it <drupal-pod-name> -- bash进入Drupal容器 - 执行连通性测试命令:
nc -zv drupal-mysql-service 3306,返回连接成功即代表网络通路正常。
- 先执行
- 返回Drupal安装页填写数据库参数:
- 数据库名:
drupal_databases - 数据库用户名:
root - 数据库密码:
seto_password - 数据库主机:
drupal-mysql-service(禁止填写localhost/127.0.0.1,这两个地址指向Drupal容器自身,非MySQL服务地址)
- 数据库名:
常见坑点提示
- Minikube单节点环境默认无网络ACL,只要Service选择器匹配正确,同命名空间下的Pod可直接通过Service名访问对方服务,无需额外配置网络策略。
- 若连通性测试仍失败,可检查两个Pod是否处于同一命名空间,跨命名空间访问需要在Service名后补充命名空间后缀(如
drupal-mysql-service.default.svc.cluster.local)。
内容的提问来源于stack exchange,提问作者MetalBearSolid
相关产品推荐
相关产品推荐

