GCP TPU环境下Flask API报gcloud not found，单独运行脚本正常如何排查？

1. 优先核查Flask进程的环境变量差异 #

该错误本质是Flask运行进程的PATH环境变量中没有包含gcloud命令的安装路径，可按以下步骤验证：

• 在Flask接口中临时增加调试逻辑，打印当前进程的PATH值，和你直接登录TPU执行echo $PATH的结果对比，确认gcloud所在路径是否缺失：

import os
from flask import Flask
app = Flask(__name__)

@app.route('/debug-env')
def debug_env():
    return os.environ.get('PATH', '')

• 执行which gcloud拿到gcloud的实际安装路径（默认通常为/root/google-cloud-sdk/bin/gcloud或者/home/<当前登录用户名>/google-cloud-sdk/bin/gcloud），检查该路径是否存在于Flask进程的PATH中。

2. 排查Flask启动方式带来的环境差异 #

• 如果你用systemd、supervisor等守护进程工具启动Flask，这类工具默认会重置进程环境变量，不会继承登录用户的PATH配置，需要在启动配置文件中显式将gcloud路径加入PATH，或者直接用gcloud的绝对路径调用。
• 如果你用sudo启动Flask，sudo默认会重置环境变量，可加-E参数保留当前用户的环境变量，或修改sudoers配置允许保留PATH变量。
• 若Flask的运行账号和你手动执行test.py的账号不是同一个，不同账号的~/.bashrc、~/.profile中的PATH配置不共享，需要给Flask运行账号单独配置gcloud路径，或者将gcloud安装到/usr/local/bin这类系统级公共路径。

3. 快速规避方案 #

如果不想排查环境变量问题，可直接修改代码用gcloud的绝对路径调用，比如你which gcloud拿到的路径是/home/user/google-cloud-sdk/bin/gcloud，修改后代码如下：

@functools.lru_cache()
def get_project():
    return subprocess.check_output("/home/user/google-cloud-sdk/bin/gcloud config list --format 'value(core.project)'", shell=True).decode(
        "utf-8").strip()

更推荐的方案是直接调用GCP元数据服务获取项目ID，不需要依赖本地安装的gcloud命令，稳定性更高，示例如下：

import requests
@functools.lru_cache()
def get_project():
    return requests.get("http://metadata.google.internal/computeMetadata/v1/project/project-id", headers={"Metadata-Flavor": "Google"}).text

4. 验证TPU和GCP VM的环境差异 #

GCP VM默认会将gcloud安装到系统级公共路径，所有用户都可直接访问；但TPU环境通常默认是用户级安装gcloud，只有安装时的登录用户PATH中包含对应路径，切换其他账号启动进程就会找不到命令，这是两个环境表现不一致的常见原因。

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