Google Cloud Functions部署不支持符号链接的问题及解决方案咨询

问题说明 #

Google Cloud Functions要求函数源目录必须包含main.py、requirements.txt和__init__.py，本地依赖必须放在源目录内部，无法直接导入同级或上级目录的模块。现有目录结构：

base/
   __init__.py
   code_sibling.py
functions/
   f/
      __init__.py
      main.py
      requirements.txt
      internal/
         __init__.py
         code_internal.py

常规Python环境下用符号链接能导入base/code_sibling.py，但gcloud functions deploy会忽略符号链接，目前只能手动复制base/到functions/f/后部署再删除，以下是更优替代方案：

• 方案1：动态添加模块搜索路径
  在functions/f/main.py开头加入代码，把base/所在的项目根目录添加到Python的模块搜索路径：

  import sys
  from pathlib import Path
  
  # 定位到项目根目录（base和functions的父目录）
  project_root = Path(__file__).resolve().parent.parent.parent
  sys.path.append(str(project_root))
  
  # 正常导入base模块
  from base import code_sibling
  

  部署时必须指定项目根目录作为部署源，执行命令：

  gcloud functions deploy YOUR_FUNCTION_NAME --runtime python311 --trigger-http --source ./
  

  这样部署包会包含base/目录，配合代码里的路径配置就能正常导入。

• 方案2：自动化复制依赖的部署脚本
  写个脚本替代手动复制删除操作，避免重复劳动。示例Shell脚本（deploy_f.sh）：

  #!/bin/bash
  
  # 复制base到函数目录
  cp -r ../base ./functions/f/
  
  # 部署函数（替换成你的函数名和参数）
  gcloud functions deploy YOUR_FUNCTION_NAME --runtime python311 --trigger-http --source ./functions/f/
  
  # 清理复制的base目录
  rm -r ./functions/f/base
  

  执行前给脚本加权限：chmod +x deploy_f.sh，之后直接运行脚本即可完成部署。

• 方案3：将base打包为本地Python包
  把base/改成可安装的本地包，这样能通过requirements.txt管理依赖：

  1. 在base/目录下创建pyproject.toml：

     [build-system]
     requires = ["setuptools>=61.0"]
     build-backend = "setuptools.build_meta"
     
     [project]
     name = "base"
     version = "0.1.0"
     

  2. 在functions/f/requirements.txt中添加本地依赖：

     -e ../../base
     

  3. 部署时指定项目根目录作为源：

     gcloud functions deploy YOUR_FUNCTION_NAME --runtime python311 --trigger-http --source ./
     

  部署工具会自动安装这个本地包到函数运行环境，无需手动复制文件。

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