Flutter Web部署异常：无法获取URL参数读取Firestore文档

核心问题点 #

1. 空安全未处理：getInitialLink()可能返回null，直接强转link as String会触发空指针异常。
2. 异步逻辑冗余且顺序错误：initializeAndGetLocationAndProjectDoc方法接收id参数却未使用，内部调用getLocationId()会覆盖值；同时FutureBuilder初始化时传入的initialLink.value尚未被异步方法赋值，逻辑矛盾。
3. Uri解析场景覆盖不全：未处理getInitialLink()返回null的情况，仅判断查询参数为空的场景。

修复后的代码示例 #

1. 修正getLocationId方法 #

Future<void> getLocationId() async {
  final String? link = await getInitialLink();
  // 处理链接为null的场景，直接使用默认ID
  if (link == null) {
    initialLink.value = "FJ9ISNeHjkbD5Uok5Eco";
    return;
  }
  // 解析链接获取问号后的文档ID
  final uri = Uri.parse(link);
  final docId = uri.query;
  // 若查询参数为空，使用默认ID兜底
  initialLink.value = docId.isEmpty ? "FJ9ISNeHjkbD5Uok5Eco" : docId;
}

2. 简化初始化方法 #

移除冗余参数，确保逻辑连贯：

Future<void> initializeAndGetLocationAndProjectDoc() async {
  await getLocationId();
  await getLocationAndProjectDoc(initialLink.value);
}

3. 修正FirstPage的FutureBuilder调用 #

调用无参数的初始化方法，避免传入未初始化的空值：

class FirstPage extends StatelessWidget {
  FirstPage({super.key});
  final projectServiceController = Get.put(ProjectService());

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('First page'),
      ),
      body: Center(
        child: FutureBuilder(
          future: projectServiceController.initializeAndGetLocationAndProjectDoc(),
          builder: (context, snapshot) {
            if (snapshot.connectionState == ConnectionState.waiting) {
              return const CircularProgressIndicator();
            } else if (snapshot.hasError) {
              return Text('错误: ${snapshot.error}');
            } else {
              return Column(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  Text('${projectServiceController.projectName.value}'),
                  Text('${projectServiceController.locationName.value}'),
                ],
              );
            }
          },
        ),
      ),
    );
  }
}

额外优化建议 #

• 适配键值对参数格式：如果后续需要将链接改为?docId=745763098258940780594的标准格式，可改用uri.queryParameters['docId']来获取参数，扩展性更强。
• 配置Web端路由重写：在Firebase Hosting的firebase.json中添加重写规则，避免刷新页面出现404：

  {
    "hosting": {
      "rewrites": [
        {
          "source": "**",
          "destination": "/index.html"
        }
      ]
    }
  }
  

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