如何以服务账号身份本地运行GCP Cloud Function并访问资源？

方法1：使用服务账号密钥文件认证 #

• 在GCP控制台找到对应服务账号，创建并下载JSON格式的密钥文件（仅用于本地开发，绝对不能泄露或提交到代码仓库）
• 设置环境变量指向密钥文件：
  • Windows：set GOOGLE_APPLICATION_CREDENTIALS="C:\绝对路径\service-account-key.json"
  • macOS/Linux：export GOOGLE_APPLICATION_CREDENTIALS="/绝对路径/service-account-key.json"
• 直接运行本地云函数代码，GCP SDK会自动读取该环境变量，以对应服务账号的权限访问GCS等资源

方法2：通过gcloud SDK配置应用默认凭据 #

• 确保本地已安装并初始化gcloud SDK（执行gcloud init完成项目和账号配置）
• 若要直接使用生产环境的服务账号身份，执行：gcloud auth activate-service-account --key-file=/路径/to/service-account-key.json
• 若用拥有对应资源权限的个人账号，执行：gcloud auth application-default login，按提示完成登录
• 确认当前GCP项目正确：gcloud config set project your-project-id
• 运行本地代码即可自动使用凭据认证

方法3：使用Cloud Functions本地模拟器 #

• 以Node.js为例，安装模拟器工具：npm install -g @google-cloud/functions-framework
• 在函数代码目录下启动本地服务：functions-framework --target=你的函数名
• 配合上述任意一种凭据配置，即可通过HTTP请求（如http://localhost:8080）调用本地函数，模拟云端运行环境访问资源

注意事项 #

• 服务账号密钥文件务必妥善保管，添加到.gitignore避免泄露
• 本地测试用的账号权限尽量与生产环境服务账号保持一致，避免出现测试通过但部署后报错的情况
• 若遇到权限问题，可通过gcloud projects get-iam-policy your-project-id检查账号权限配置

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