如何部署带有本地共享依赖的Google Cloud Function？

以下是经过验证的3种可行方案，按优先级从高到低排列：

方案1：调整部署根目录（最优，无需修改业务代码） #

Cloud Function 部署时支持指定任意上层目录为部署根目录，只需同步修改入口函数的引用路径即可，完全保留原项目的导入逻辑：

• 部署时将工作目录切换到 parent_repo/parent/ 路径下，而非cloud_function子目录
• 部署命令中入口函数参数修改为 cloud_function.main.<你的云函数触发方法名>
• 可将cloud_function下的requirements.txt移动到parent目录下，或者部署时添加--requirements=cloud_function/requirements.txt参数指定依赖文件路径
• 可选：在parent目录下新增.gcloudignore文件，排除不需要上传的冗余目录（如other_module/等），缩小部署包体积
  该方案下整个parent包都会被上传到云函数运行环境，原有的绝对导入语句无需任何修改即可正常运行。

方案2：运行时动态添加父目录到模块搜索路径 #

如果必须保留以cloud_function为部署根目录的配置，可以在main.py的最开头添加路径注入代码，让Python解释器能识别父级的parent包：

import sys
from pathlib import Path
# 将parent目录加入模块搜索路径
sys.path.append(str(Path(__file__).parent.parent.resolve()))
# 后续原有导入逻辑保持不变
from parent.shared_module.package1 import some_func
from parent.shared_module.package2 import some_class

该方案只需修改3行代码，无需调整部署配置，适合临时快速适配的场景。

方案3：将共享模块封装为本地可安装包 #

如果共享模块迭代稳定，可将其封装为标准Python包，在依赖中直接引用：

• 给shared_module目录添加pyproject.toml或setup.py打包配置
• 在cloud_function/requirements.txt中添加相对路径引用：../shared_module/
• 部署时云函数会自动安装该共享包，原有导入逻辑保持不变
  该方案适合多服务共用共享模块、需要做版本管理的场景。

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