Flutter Web使用Realtime Database模拟器时出现无效路径错误

问题核心 #

你遇到的错误是因为错误地将完整的模拟器URL作为数据库节点路径传给了ref()/child()方法，而Firebase Realtime Database的路径参数只接受相对节点路径（不能包含URL协议、主机、端口，也不能有.、#等特殊字符）。

修复步骤 #

1. 正确配置模拟器初始化
   不要把完整URL传入数据库实例，而是用useDatabaseEmulator方法指定模拟器的主机和端口：

   import 'package:firebase_database/firebase_database.dart';
   
   // 初始化数据库实例
   final database = FirebaseDatabase.instance;
   // 配置模拟器（主机用localhost或你的本地IP，端口默认4000）
   await database.useDatabaseEmulator('localhost', 4000);
   

   这里不需要添加/database/projectName这类路径，Firebase会自动结合项目配置处理。

2. 修正get()方法的路径参数
   调用get()时，只传入目标数据节点的相对路径，比如：

   // 正确：直接传节点路径
   final snapshot = await database.ref('data').get();
   

   禁止传入完整的模拟器URL（比如http://xxx:4000/database/projectName/data/），这会被识别为无效的节点路径。

3. 确认firebase_options.dart配置
   flutterfire生成的配置文件无需修改，生产环境的数据库URL会被模拟器配置自动覆盖，保持默认即可。

补充说明 #

Flutter Web完全支持Realtime Database模拟器，你的问题和平台无关，仅为路径参数传递错误导致。

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