Kubernetes部署Flask API出现“localhost未发送任何数据”错误排查

1. 确认Flask应用的监听地址 #

Flask默认仅绑定127.0.0.1，这会导致容器外部（包括Kubernetes Service）无法访问应用。必须在启动Flask时指定绑定0.0.0.0：

# src/main.py中确保启动代码如下
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8000)

若未设置host='0.0.0.0'，即使本地Docker运行时能访问（部分本地Docker环境的特殊兼容），Kubernetes集群内的Service也无法通过容器的127.0.0.1端口连接应用。

2. 检查Pod运行状态 #

执行命令查看Pod是否正常启动：

kubectl get pods -l app=urban-dictionary-api-unofficial

若Pod状态为CrashLoopBackOff或Error，查看Pod日志定位错误：

kubectl logs <pod-name>

日志可能暴露依赖缺失、代码报错或端口占用等问题。

3. 验证Service与Pod的关联 #

检查Service是否正确匹配到Pod：

kubectl describe service urban-dictionary-api-unofficial-service

查看输出中的Endpoints字段，若显示Pod的IP和8000端口，说明关联正常；若为空，需再次核对Deployment的matchLabels与Service的selector标签是否完全一致（你的配置中标签匹配，此步骤大概率无问题，但需确认）。

4. 调整本地集群的访问方式 #

从你提供的kubectl get service输出看，EXTERNAL-IP为localhost，这是minikube、kind等本地K8s环境的典型表现：

• 直接通过NodePort端口访问：浏览器打开http://localhost:31048（对应输出中的31048/TCP）
• 若使用minikube，可执行命令自动映射访问地址：

minikube service urban-dictionary-api-unofficial-service

5. 测试容器内端口连通性 #

若以上步骤均无问题，进入Pod内部验证应用是否在8000端口正常监听：

kubectl exec -it <pod-name> -- /bin/bash
# 在Pod内执行
curl localhost:8000

若返回正常响应，说明应用本身无问题；若无响应，回到第一步确认Flask的监听地址配置。

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