部署Firebase V2云函数遇循环报错：路径解析与导出冲突

问题场景 #

当前陷入两难循环：

• 使用官方推荐的导入路径时，Lint检查失败：

  import { onDocumentUpdated } from 'firebase-functions/v2/firestore';
  

  执行yarn lint抛出错误：

  /XXX/functions/src/notifications/sendNotification.ts
    2:35  error  Unable to resolve path to module 'firebase-functions/v2/firestore'  import/no-unresolved
  
  ✖ 1 problem (1 error, 0 warnings)
  

• 改用直接指向lib目录的路径时，部署失败：

  import { onDocumentUpdated } from 'firebase-functions/lib/v2/providers/firestore';
  

  执行firebase deploy抛出错误：

  Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './lib/v2' is not defined by "exports" in /XXX/functions/node_modules/firebase-functions/package.json
      at exportsNotFound (node:internal/modules/esm/resolve:303:10)
      at packageExportsResolve (node:internal/modules/esm/resolve:650:9)
      at resolveExports (node:internal/modules/cjs/loader:591:36)
      at Module._findPath (node:internal/modules/cjs/loader:668:31)
      at Module._resolveFilename (node:internal/modules/cjs/loader:1130:27)
      at Module._load (node:internal/modules/cjs/loader:985:27)
      at Module.require (node:internal/modules/cjs/loader:1235:19)
      at require (node:internal/modules/helpers:176:18)
      at Object.<anonymous> (/XXX/functions/lib/index.js:28:14)
      at Module._compile (node:internal/modules/cjs/loader:1376:14) {
    code: 'ERR_PACKAGE_PATH_NOT_EXPORTED'
  }
  
  Error: Functions codebase could not be analyzed successfully. It may have a syntax or runtime error
  

查看firebase-functions的package.json，确认v2/firestore路径已正确导出：

{
  "exports": {
    "v2": [
      "lib/v2"
    ],
    "v2/core": [
      "lib/v2/core"
    ],
    "v2/alerts": [
      "lib/v2/providers/alerts"
    ],
    "v2/database": [
      "lib/v2/providers/database"
    ],
    "v2/https": [
      "lib/v2/providers/https"
    ],
    "v2/firestore": [
      "lib/v2/providers/firestore"
    ]
    // ...其他v2子路径省略
  }
}

原因分析 #

Lint的import/no-unresolved规则无法识别firebase-functions/v2/firestore路径，本质是ESLint的导入解析器（默认或配置的resolver）未读取package.json中的exports字段，导致无法映射到实际的文件路径。常见触发场景：

• ESLint导入解析器版本过旧，不支持package.json exports字段
• TypeScript项目中，ESLint未正确配置TypeScript解析器，无法识别导出路径

解决方案 #

1. 保留官方推荐的导入路径 #

始终使用import { onDocumentUpdated } from 'firebase-functions/v2/firestore';，这是Firebase官方指定的合法导入方式，部署时能正确识别。

2. 配置ESLint以支持package.json exports #

纯JavaScript项目

安装并配置eslint-import-resolver-node，确保其版本支持exports字段：

yarn add eslint-import-resolver-node --dev

在.eslintrc.js中添加解析器配置：

module.exports = {
  // ...其他配置
  settings: {
    'import/resolver': {
      node: {
        exportsFields: ['exports'],
        extensions: ['.js', '.jsx']
      }
    }
  }
};

TypeScript项目

使用eslint-import-resolver-typescript替代默认解析器，它能自动读取tsconfig和package.json的exports：

yarn add eslint-import-resolver-typescript --dev

在.eslintrc.js中配置：

module.exports = {
  // ...其他配置
  settings: {
    'import/resolver': {
      typescript: {
        alwaysTryTypes: true,
        project: './tsconfig.json'
      }
    }
  }
};

3. 更新依赖版本 #

确保firebase-functions、eslint、eslint-plugin-import及对应解析器都是最新稳定版：

yarn upgrade firebase-functions eslint eslint-plugin-import eslint-import-resolver-typescript

4. 清除缓存并重新安装依赖 #

yarn cache clean
rm -rf node_modules yarn.lock
yarn install

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