如何在GCP生产云函数的requirements.txt中导入开发项目的Artifact Registry

能不能通过requirements.txt实现跨项目导入？ #

可以，但直接照搬开发环境的配置肯定会报错，得解决权限和格式两个核心问题。

常见错误的解决步骤 #

1. 先搞定权限问题 #

生产环境的Cloud Function默认使用的服务账号（一般是[生产项目ID]@appspot.gserviceaccount.com）没有访问开发项目Artifact Registry的权限，这是最常见的报错原因。

• 操作步骤：
  • 打开开发项目的Artifact Registry控制台，找到目标仓库
  • 进入「权限」页面，添加生产环境的那个服务账号
  • 给它分配Artifact Registry Reader角色，保存后等待几分钟让权限生效

2. 修正requirements.txt的格式 #

跨项目引用私有包不能只写包名，必须明确指定仓库地址：

• 单包引用的正确写法：

  your-package-name @ https://[区域]-python.pkg.dev/[开发项目ID]/[仓库名]/your-package-name/[版本号].tar.gz
  

• 多包批量引用的写法（用额外索引地址）：

  --extra-index-url https://[区域]-python.pkg.dev/[开发项目ID]/[仓库名]/simple/
  your-package-name==1.0.0
  another-package==2.1.0
  

  提醒：如果是本地部署测试，可能需要额外配置凭证，但Cloud Function部署时会自动用服务账号权限，不用手动加凭证

3. 排查仓库和网络配置 #

• 检查开发项目的Artifact Registry仓库是否允许生产项目的VPC访问（如果用了私有VPC）
• 核对仓库的区域、项目ID、仓库名称有没有拼写错误，地址错了肯定导不进来

提前验证的小技巧 #

部署Cloud Function前，先在本地用pip安装测试：

pip install -r requirements.txt --extra-index-url https://[区域]-python.pkg.dev/[开发项目ID]/[仓库名]/simple/

如果本地能装成功，再部署到生产环境，基本就不会出问题了。

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