Firebase App Hosting误将Python Flask应用识别为Node.js致部署失败

一、清除Node.js残留触发文件 #

• 删掉项目根目录下的package.json、package-lock.json和node_modules文件夹——这些是Cloud Build自动检测Node.js的核心依据，留着就会干扰识别。
• 执行firebase clear命令，清空Firebase CLI本地缓存，避免旧配置残留影响检测逻辑。

二、硬指定Python运行时配置 #

• 用apphosting.yaml强制声明：在项目根目录创建或修改该文件，内容如下：

  runtime: python
  entrypoint: gunicorn main:app
  env: standard
  

  这个配置优先级高于自动检测，直接告诉Cloud Build使用Python运行时。
• 配合firebase.json锁定运行逻辑：修改firebase.json，明确指定启动命令，跳过自动检测：

  {
    "hosting": {
      "source": ".",
      "runCommand": "gunicorn main:app",
      "ignore": [
        "firebase.json",
        "**/.*",
        "**/node_modules/**"
      ]
    }
  }
  

三、重置Firebase Hosting构建环境 #

• 重新初始化Hosting（保留现有项目）：执行firebase init hosting，初始化过程中不要选择单页应用选项，明确告知CLI这是后端服务。
• 手动指定Cloud Build镜像：如果自动检测仍失效，在根目录创建cloudbuild.yaml，直接指定Python构建流程：

  steps:
  - name: 'python:3.11'
    entrypoint: 'pip'
    args: ['install', '-r', 'requirements.txt', '--user']
  - name: 'python:3.11'
    entrypoint: 'gunicorn'
    args: ['main:app']
  

  部署时执行firebase deploy --only hosting --config cloudbuild.yaml，强制使用该配置构建。

四、验证配置并重新部署 #

• 检查所有配置文件，确保没有残留Node.js相关的配置项。
• 执行firebase deploy --only hosting --debug查看调试日志，确认Cloud Build是否拉取Python镜像而非Node.js镜像。

内容的提问来源于stack exchange，提问作者Krzysztof Gołębiowski