部署Firebase Functions时遭遇ERR_PACKAGE_PATH_NOT_EXPORTED错误求助

问题根源 #

错误提示Package subpath './lib/firestore' is not defined by "exports"是因为firebase-admin v11+重构了模块导出结构，移除了./lib/firestore这类内部子路径的导出，而你的代码（或依赖库）仍在使用旧的导入方式。

解决方案 #

方案1：修正代码中的导入语句 #

检查你的Cloud Functions代码（index.ts或相关业务文件），把所有直接引用firebase-admin/lib/firestore的导入替换为官方推荐的方式：

旧写法（错误）：

import * as firestore from 'firebase-admin/lib/firestore';
// 或者
import { FieldValue } from 'firebase-admin/lib/firestore';

新写法（正确）：

// 导入整个firestore模块
import { firestore } from 'firebase-admin';

// 导入具体类型或方法
import { FieldValue, Timestamp } from 'firebase-admin/firestore';

方案2：降级firebase-admin到兼容版本 #

如果你的代码依赖的第三方库（比如node-apple-receipt-verify）暂不支持firebase-admin v11，可以降级到v10.x版本（该版本保留旧的导出路径）：

执行命令：

npm install firebase-admin@10.3.0 --save

后续操作 #

完成上述修改后，重新构建并部署：

npm run build
firebase deploy

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