TypeScript React集成Firebase实时数据库报database不存在ts(2339)

报错根因 #

你遇到的ts(2339) property 'database' does not exist on type 'firebaseapp'报错，核心原因是Firebase版本API不兼容：你参考的教程用的是Firebase v8及之前的命名空间式API，而你本地安装的是v9+的模块化API，两种版本的初始化、数据库调用写法完全不同，类型定义也不匹配。

两种修复方案（二选一即可） #

方案1：降级到和教程匹配的Firebase v8版本 #

• 卸载当前高版本Firebase：npm uninstall firebase
• 安装v8最终稳定版：npm install firebase@8.10.0
• 安装对应版本类型定义包：npm install @types/firebase@8.10.0 -D
• 调整后你的配置代码可以和教程写法完全对齐，不会再触发该类型错误。

方案2：适配现有v9+版本的模块化写法 #

无需降级，修改配置代码适配新API即可：

1. 确保导入实时数据库模块，v9+版本需要单独导入对应模块才能使用相关功能：

// 导入v9+模块化API
import { initializeApp } from "firebase/app";
import { getDatabase } from "firebase/database";

// 替换为你的Firebase控制台拿到的项目配置
const firebaseConfig = {
  apiKey: "你的项目apiKey",
  authDomain: "你的项目authDomain",
  databaseURL: "你的项目databaseURL",
  projectId: "你的项目projectId",
  storageBucket: "你的项目storageBucket",
  messagingSenderId: "你的项目messagingSenderId",
  appId: "你的项目appId"
};

// 初始化Firebase应用
const app = initializeApp(firebaseConfig);
// 初始化实时数据库，后续直接导出db实例调用即可
export const db = getDatabase(app);

2. 后续数据库增删改查操作也需要同步使用v9+模块化API，比如读取数据用get()、onValue()等方法，替代旧版的ref().once()写法即可。

额外排查项 #

如果确认版本匹配后仍报错，可检查两点：

• v8版本需要额外导入数据库模块才会在app实例上挂载database方法，确保配置文件里有import 'firebase/database'语句
• Firebase主包和类型定义包的版本必须完全一致，避免版本不匹配导致的类型误报

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