React Native中Firebase Cloud Functions部署失败：文件冲突与重声明错误

问题根源 #

你的Cloud Functions目录与React Native项目共享根目录，TypeScript编译时同时加载了React Native的@types/react-native和Cloud Functions默认引入的DOM类型库（lib.dom.d.ts），二者对全局对象（如MediaError的error属性）的类型声明不一致，触发重声明错误。

解决方案 #

1. 给Cloud Functions配置独立TypeScript规则 #

在functions文件夹下创建或修改tsconfig.json，明确针对Node.js环境编译，隔离React Native的类型干扰：

{
  "compilerOptions": {
    "module": "commonjs",
    "noImplicitReturns": true,
    "noUnusedLocals": true,
    "outDir": "lib",
    "sourceMap": true,
    "strict": true,
    "target": "ES2017",
    // 移除DOM库，仅保留Node.js相关语法库
    "lib": ["ES2017"],
    // 仅使用functions目录内的@types，避免加载上层React Native类型
    "typeRoots": ["./node_modules/@types"]
  },
  "compileOnSave": true,
  "include": ["src/**/*.ts"],
  // 排除上层目录的React Native依赖文件
  "exclude": ["../node_modules", "node_modules", "lib"]
}

2. 确保Cloud Functions依赖独立 #

切换到functions目录，重新安装专属依赖，避免和React Native依赖混淆：

cd functions
npm install firebase-functions firebase-admin typescript @types/node --save

3. 清理产物后重新部署 #

cd functions
rm -rf lib
firebase deploy --only functions

额外注意事项 #

• 不要在React Native根目录直接执行部署命令，务必切换到functions目录操作，避免加载React Native环境配置。
• 如果根目录存在全局tsconfig.json，可添加排除规则，让根目录TypeScript编译忽略functions目录：

{
  "exclude": ["functions"]
}

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