Kubernetes配置Ingress后访问localhost返回ERR_EMPTY_RESPONSE问题

• 部署的Ingress Nginx控制器适配环境错误：你使用的cloud provider部署清单是面向公有云环境设计的，不会自动为Docker Desktop内置K8s做宿主机端口绑定，控制器80/443端口没有映射到本地localhost，直接访问自然无响应。
• Ingress规则可能未被控制器识别：v0.46.0版本的Ingress控制器要求显式指定Ingress类，部分示例项目的Ingress配置缺失对应注解或ingressClassName字段，导致路由规则不生效。
• 业务工作负载异常：如果k8s目录下部署的React、Node服务、Postgres、Nginx相关Pod未正常运行，Service没有可用后端端点，就算Ingress链路通了也无法正常响应请求。
• 本地端口占用：如果本机80端口被其他服务（如本地Nginx、Apache、其他Web程序）占用，会导致Ingress控制器无法绑定端口，访问直接返回空响应。

1. 清理错误部署的Ingress控制器

kubectl delete -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v0.46.0/deploy/static/provider/cloud/deploy.yaml

等待所有相关资源删除完成后，部署适配Docker Desktop环境的同版本Ingress控制器：

kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v0.46.0/deploy/static/provider/docker-desktop/deploy.yaml

2. 等待控制器就绪
   执行命令实时观察控制器Pod状态：

kubectl get pods -n ingress-nginx -w

等ingress-nginx-controller开头的Pod状态变为Running，且READY列显示1/1后，按Ctrl+C退出监听。
执行以下命令验证端口映射正常：

kubectl get svc -n ingress-nginx ingress-nginx-controller

返回结果中EXTERNAL-IP列显示localhost，且80/443端口在PORT(S)列存在映射，说明控制器部署正常。

3. 排查业务资源状态

• 执行kubectl get pods查看所有业务Pod状态，若存在CrashLoopBackOff、ImagePullBackOff、Error类异常：
  • 镜像拉取失败先配置Docker镜像加速器，重新拉取镜像
  • 容器启动崩溃执行kubectl logs <异常Pod名称>查看日志，排查环境变量配置错误、数据库连接地址错误等问题
• 执行kubectl get endpoints查看所有Service关联的后端端点，确认每个业务Service都能匹配到对应的Pod IP，不存在端点为空的情况。

4. 修正Ingress配置
   打开k8s目录下的Ingress资源YAML文件：

• 如果apiVersion为networking.k8s.io/v1，在spec下添加字段ingressClassName: nginx
• 在metadata.annotations下添加注解kubernetes.io/ingress.class: nginx
  修改完成后重新执行部署命令加载配置：

kubectl apply -f k8s

5. 端口占用排查
   执行命令查看本机80端口占用情况：

• Windows：netstat -ano | findstr :80
• macOS/Linux：lsof -i :80
  如果存在非Docker进程占用80端口，停掉对应进程后重启Ingress控制器Pod即可。

完成以上步骤后等待10秒左右，再访问http://localhost即可正常打开示例项目。如果还是异常，执行kubectl logs -n ingress-nginx -l app.kubernetes.io/name=ingress-nginx --tail=100查看控制器日志，排查规则加载、请求转发的具体错误。

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