如何在Visual Studio Code中调试Cloud Run本地运行故障

你遇到的报错核心是本地K8s集群中的Cloud Run模拟容器反复重启，导致Skaffold部署失败，可按以下顺序排查：

• 第一步：拉取容器崩溃日志定位根本原因
  先执行命令获取失败的Pod名称：
  kubectl get pods -A
  找到命名空间中状态为CrashLoopBackOff的Pod，再执行命令拉取上一次崩溃的运行日志：
  kubectl logs <你的Pod名称> --previous -n <对应命名空间>
  该日志会直接输出Flask运行错误、gunicorn启动错误、依赖缺失等具体问题，是最直接的排查依据。
• 第二步：验证入口文件匹配规则
  你的Dockerfile启动命令指定入口为main:app，需确认两个配置：
  1. 项目根目录下存在名为main.py的入口文件
  2. main.py中初始化的Flask实例名称必须为app，例如：

  from flask import Flask
  app = Flask(__name__) # 此处变量名必须为app，否则gunicorn无法找到入口
  

  如果你的Flask实例变量名不是app，需将启动命令中的main:app对应改为main:<你的实例变量名>。
• 第三步：解决依赖冲突问题
  当前配置存在重复安装依赖、旧调试包兼容问题，可做以下修改：
  1. 删除Dockerfile中RUN pip install flask和RUN pip install gunicorn两行，将gunicorn添加到requirements.txt中，避免重复安装导致版本冲突
  2. requirements.txt中的ptvsd是已停止维护的旧调试包，与新版Python 3存在兼容性问题，可替换为debugpy，或临时注释该行验证是否是调试包导致的启动失败。
• 第四步：单独测试Docker镜像排除模拟器问题
  先绕开Cloud Run模拟器，直接本地构建运行Docker镜像验证镜像本身是否正常：
  1. 构建镜像：docker build -t test-flask-run .
  2. 启动容器：docker run -p 8080:8080 test-flask-run
     如果容器启动后直接崩溃，说明问题出在镜像本身，可结合容器输出的报错排查；如果容器运行正常，访问localhost:8080能收到响应，说明是Cloud Code插件、Skaffold配置或本地K8s集群的问题，可尝试重启Cloud Code插件、重置本地K8s集群后重试。
• 第五步：检查端口占用情况
  确认本地8080端口未被其他进程占用，可执行命令查看端口占用：
  netstat -ano | findstr :8080
  如果有其他进程占用8080端口，可结束对应进程，或修改Dockerfile、Cloud Run调试配置中的端口号。

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