页面空白通常源于使用了已废弃的 firebase v8 兼容层(`firebase/compat/app`),而项目实际运行在 firebase v9+ 模块化 sdk 环境下,造成运行时错误未被捕获、react 应用崩溃。正确做法是迁移到 v9+ 标准模块化导入方式。
Firebase 自 v9 起全面转向模块化(modular)SDK 设计,大幅优化包体积与 Tree-shaking 支持。但许多开发者仍沿用旧版 firebase/compat/app 导入方式(即“兼容层”),这在纯 ES 模块环境(如现代 Create React App 或 Vite)中极易引发静默失败:浏览器控制台可能报错 TypeError: firebase.initializeApp is not a function 或 auth is undefined,而 React 因未捕获的异常直接渲染为空白页(白屏),且无明显编译错误。
✅ 正确迁移方案(推荐 Firebase v9+ 标准模式):
修改后的 firebase.js(推荐命名为 firebaseConfig.js)如下:
// src/firebaseConfig.js import { initializeApp } from 'firebase/app'; import { getFirestore } from 'firebase/firestore'; import { getAuth, GoogleAuthProvider } from 'firebase/auth'; const firebaseConfig = { apiKey: "***", authDomain: "***", projectId: "***", storageBucket: "***", messagingSenderId: "***", appId: "***", measurementId: "***" }; // 初始化 Firebase 应用实例 const app = initializeApp(firebaseConfig); // 获取服务实例(按需导入,避免冗余) export const db = getFirestore(app); export const auth = getAuth(app); export const provider = new GoogleAuthProvider();
对应更新 Login.js 中的导入与事件处理:
import React from 'react';
import './Login.css';
import { Button } from '@mui/material';
import { auth, provider } from './firebaseConfig'; // ✅ 使用新路径
import { signInWithPopup } from 'firebase/auth'; // ✅ 显式导入方法
function Login() {
const signIn = async () => {
try {
await signInWithPopup(auth, provider); // ✅ 使用函数式调用
} catch (error) {
console.error('Sign-in error:', error);
alert(`登录失败:${error.message}`);
}
};
return (
Welcome to Chatlytic
{/* ⚠️ 注意:React 中事件属性为 onClick,不是 onclick */}
);
}
export default Login;? 关键注意事项:
npm install firebase@latest
? 补充说明:若因历史原因必须保留兼容层(不推荐),则需全局安装 firebase@8 并禁用自动升级,但会失去性能优化与长期维护支持。生产项目应坚定采用 v9+ 模块化范式。
完成上述修改后,重启开发服务器,页面将正常渲染,点击按钮即可触发 Google 登录弹窗——白屏问题彻底解决。