Firebase Python云函数部署时无法导入本地包的问题求助

问题详情 #

我的Firebase云函数目录结构如下：

functions
|--localpackage
|  |-__init__.py
|  |-constants.py
|-main.py
|-requirements.txt

在main.py中使用from localpackage.constants import *导入本地模块，本地通过functions-framework --target testPy --debug测试运行正常，但执行firebase deploy --only functions部署时，触发错误：

from localpackage.constants import *
ModuleNotFoundError: No module named 'localpackage'

可行解决方案 #

方案1：通过环境变量指定模块搜索路径 #

在functions目录下创建.env文件，写入以下内容：

PYTHONPATH=/workspace

Firebase部署过程中会读取该环境变量，将云函数的根工作目录加入Python模块搜索路径，从而识别localpackage。

方案2：手动添加路径到Python搜索列表 #

在main.py的最开头添加以下代码，将当前脚本所在目录加入Python的模块搜索路径：

import sys
from pathlib import Path

# 将当前文件所在目录添加到搜索路径
sys.path.append(str(Path(__file__).parent))

# 之后执行导入
from localpackage.constants import *

方案3：将本地包作为可安装依赖（推荐） #

这是最符合Python依赖管理规范的方式，步骤如下：

1. 在localpackage目录下创建setup.py文件，内容示例：

from setuptools import setup, find_packages

setup(
    name="localpackage",
    version="0.1.0",
    packages=find_packages(),
)

2. 在requirements.txt中添加本地包的相对路径：

./localpackage

部署时Firebase会自动安装这个本地包，原有导入语句无需修改。

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