本地无法访问部署在Minikube上的Flask应用问题排查

我开发了一款Flask应用，将其打包为容器运行，部署到Minikube集群后出现服务无法连通的问题。

已有的配置与部署信息 #

• Dockerfile配置

FROM python:3.7
LABEL MAINTAINER="Anirban"
RUN mkdir /app
WORKDIR /app
COPY . /app/
RUN pip install -r requirements.txt
RUN python setup.py install
ENV PORT 5000
ENV SERVER_NAME "0.0.0.0:5000"
EXPOSE 5000
CMD [ "python", "userapp/app.py" ]

• 应用项目结构

[project] 
    |
    --userapp
    |    |
    |     --app.py
    --Dockerfile

• Flask应用核心配置代码

def initialize_app(flask_app):
    flask_app.register_blueprint(SWAGGERUI_BLUEPRINT, url_prefix=SWAGGER_URL)
    flask_app.register_blueprint(user_endpoints.REQUEST_API)
    flask_app.config['SERVER_NAME'] = os.environ.get('SERVER_NAME', settings.FLASK_SERVER_NAME)


if __name__ == "__main__":
    initialize_app(app)
    app.run(debug=os.environ.get('FLASK_DEBUG', settings.FLASK_DEBUG))

• Kubernetes Deployment资源配置

apiVersion: apps/v1
kind: Deployment
metadata:
  name: userauthapp
  labels:
    app: userauthapp
spec:
  replicas: 1
  selector:
    matchLabels:
      app: userauthapp
  template:
    metadata:
      labels:
        app: userauthapp
    spec:
      containers:
        - name: userauthapp
          image: <my image>
          ports:
            - containerPort: 5000
          imagePullPolicy: Always

• LoadBalancer类型Service资源配置

apiVersion: v1
kind: Service
metadata:
  name: userauthapp-lb-svc
spec:
  selector:
    app: userauthapp
  ports:
    - protocol: "TCP"
      port: 8080
      targetPort: 5000
  type: LoadBalancer

• 集群部署状态输出

NAME                               READY   STATUS    RESTARTS   AGE
pod/userauthapp-6cc76bd66b-vst5n   1/1     Running   0          38s

NAME                         TYPE           CLUSTER-IP       EXTERNAL-IP   PORT(S)          AGE
service/kubernetes           ClusterIP      10.96.0.1        <none>        443/TCP          267d
service/userauthapp-lb-svc   LoadBalancer   10.107.117.254   <pending>     8080:31145/TCP   2s

异常表现 #

部署完成后，从本地执行curl命令访问上述集群内的ClusterIP地址，无论是访问健康检查路径/，还是Swagger文档路径/swagger都无法连通。 #

核心成因1：Flask服务未绑定非回环监听地址 #

Flask开发服务器默认监听地址为127.0.0.1，仅允许容器内部本地回环流量访问，无法响应来自容器外部（Pod网络、Service转发）的请求。
你在Dockerfile中设置的SERVER_NAME=0.0.0.0:5000属于Flask的路由匹配配置，用于校验请求头的Host字段，和服务实际监听的网络地址无关；且该配置设为0.0.0.0还会引发Host校验逻辑异常，可能导致请求直接被拒绝。
解决方案：

• 修改Flask启动代码，显式指定监听地址为0.0.0.0，从环境变量读取服务端口，示例：

if __name__ == "__main__":
    initialize_app(app)
    app.run(
        host=os.environ.get("HOST", "0.0.0.0"),
        port=int(os.environ.get("PORT", 5000)),
        debug=os.environ.get("FLASK_DEBUG", settings.FLASK_DEBUG)
    )

• 移除代码中设置SERVER_NAME=0.0.0.0的逻辑，该配置多用于跨子域路由场景，无相关需求时保留反而会引发路由匹配失败。

核心成因2：本地网络无法直接路由Minikube的ClusterIP地址 #

Minikube的集群网络运行在独立的虚拟机内部，ClusterIP属于虚拟机内部的虚拟网段，本地物理机的网络路由表中不存在该网段的转发规则，直接在本地宿主机上curl ClusterIP地址本身就无法连通，和服务是否正常运行无关。
同时Minikube默认未集成云厂商负载均衡实现，LoadBalancer类型的Service会一直保持EXTERNAL-IP=<pending>状态，不会分配可直接从本地访问的外部IP。
解决方案：

• 测试服务连通性时，不要直接访问ClusterIP，执行minikube service userauthapp-lb-svc命令，Minikube会自动打通本地到服务的路由并暴露访问地址。
• 也可以先通过minikube ip拿到Minikube虚拟机的IP，结合Service当前暴露的NodePort（当前环境为31145），直接访问http://<minikube_ip>:31145即可连通服务。

补充排查方向 #

如果修改上述配置后仍无法连通，可以进入Pod内部检查实际监听状态：

• 执行kubectl exec <pod名称> -- netstat -tulpn，确认应用是否真的在0.0.0.0:5000端口监听，排除容器内应用启动失败、端口被占用、实际监听端口和配置不匹配的问题。

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