如何在Firebase Python函数中导入库、正确安装并部署？

1. 正确声明依赖 #

首先确保requirements.txt中使用官方包名声明依赖（fitz是PyMuPDF的模块别名，PyPi上的正式包名为PyMuPDF）：

firebase-functions>=3.24.1
firebase-admin>=6.0.0
PyMuPDF>=1.23.0

2. 处理二进制依赖（核心问题） #

PyMuPDF依赖系统级二进制库，本地环境已预装但Cloud Run默认环境缺失，需通过以下方式解决：

方法一：预编译兼容Linux的依赖包 #

本地安装时指定Linux平台的预编译包，避免部署时Cloud Run编译失败：

# 先删除原有依赖目录
rm -rf lib
# 安装manylinux兼容的预编译包到lib目录
pip install -r requirements.txt --platform manylinux2014_x86_64 --only-binary=:all: -t lib

然后在firebase.json中配置依赖目录：

{
  "functions": {
    "source": ".",
    "runtime": "python311",
    "dependencies": {
      "dir": "lib"
    }
  }
}

方法二：自定义Cloud Build构建流程 #

如果预编译包方式失效，创建cloudbuild.yaml自定义构建步骤，先安装系统级依赖：

steps:
  - name: 'python:3.11'
    entrypoint: 'bash'
    args:
      - '-c'
      - |
        apt-get update && apt-get install -y libmupdf-dev
        pip install -r requirements.txt -t lib
  - name: 'gcr.io/firebase-tools/firebase'
    args: ['deploy', '--only', 'functions']

执行Cloud Build部署：

gcloud builds submit --config cloudbuild.yaml .

3. 验证代码导入 #

函数代码中导入方式保持不变即可：

import fitz  # 或 import PyMuPDF as fitz，两种写法均有效

4. 部署前本地验证 #

清理本地依赖后重新安装兼容包，再用模拟器确认功能正常：

rm -rf lib
pip install -r requirements.txt --platform manylinux2014_x86_64 --only-binary=:all: -t lib
firebase emulators:start --only functions

确认无问题后执行部署：

firebase deploy --only functions

常见注意事项 #

• 优先选择1.20.0以上版本的PyMuPDF，旧版本无manylinux预编译支持
• 本地开发环境（macOS/Windows）直接安装的包与Linux不兼容，必须用--platform参数指定Linux平台
• 使用Cloud Build时需确保Google Cloud账号拥有对应权限，并已关联Firebase项目

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