Flutter Web发布构建中Cloud Firestore MissingPluginException问题求助

常见修复方案 #

• 核对Firebase版本兼容性
  确保index.html中引入的Firebase JS脚本版本，和pubspec.yaml里cloud_firestore_web的版本匹配。比如pubspec里用的是cloud_firestore_web: ^4.8.0，那index.html里的Firestore脚本也要对应到相近的大版本，避免因版本不兼容导致release构建后功能异常。

• 检查Firestore安全规则
  Debug模式可能用的是宽松的测试规则，release环境的规则可能限制了读取权限。去Firebase控制台查看Firestore安全规则，确认当前用户有权限读取orders集合。可以先临时设置宽松规则测试：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /orders/{document=**} {
        allow read: if true;
        allow write: if request.auth != null;
      }
    }
  }
  

  验证问题解决后，再调整为符合业务需求的严格规则。

• 优化异步代码写法
  代码同时用了await和.then()，release构建的代码优化可能引发潜在问题，建议统一使用await简化逻辑，同时修正querySnapshot.docs的判断（它永远不会为null，用isEmpty更准确）：

  FirebaseFirestore db = FirebaseFirestore.instance;
  final querySnapshot = await db.collection('orders').where('publicOrderId', isEqualTo: orderNumber).get();
  if(querySnapshot.docs.isNotEmpty){
    // 业务逻辑
  }
  

• 重新执行发布构建
  有时候构建过程中资源打包不完整，重新执行发布构建命令：

  flutter build web --release
  

  构建完成后检查build/web目录下的index.html，确认Firebase初始化脚本和配置都正确加载。

• 确认授权域名与CORS设置
  把Web应用的生产域名添加到Firebase项目的「授权域名」列表中（Firebase控制台→项目设置→应用→Web应用→授权域名）。如果涉及跨域请求，还要检查Firestore的CORS配置是否允许当前域名访问。

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