Flutter中launchUrl在移动端异步函数内无法触发问题排查

核心问题 #

你的getSquareCheckoutLink()函数存在异步逻辑错误，导致它永远返回null，这直接导致后续的launchUrl(uri)代码从未被执行——桌面端的测试代码是直接传入uri，没调用这个函数，所以没暴露问题；移动端调用该函数时，自然不会有任何跳转行为。

错误分析 #

在getSquareCheckoutLink()中，你发起http.post请求时用了.then()回调，但既没有用await等待请求完成，也没有把这个异步操作的Future返回给外层函数。函数执行到最后一行return null时，HTTP请求还在后台运行，.then()里的返回值根本不会被外层的Future捕获，所以调用getSquareCheckoutLink().then((uri) {...})时，uri始终是null。

修正代码 #

把http.post的异步逻辑改成await语法，确保函数能正确返回请求得到的Uri：

Future<Uri?> getSquareCheckoutLink() async {
    final String idemKey = const Uuid().v1();
    final SquareAPI api = production;
    List<LineItem> lineItemList = [];
    BaseMoneyPrice youthPrice = const BaseMoneyPrice(0, "USD");
    BaseMoneyPrice adultPrice = const BaseMoneyPrice(2000, "USD");
    BaseMoneyPrice seniorPrice = const BaseMoneyPrice(1000, "USD");
    if (childTickets > 0) {
      lineItemList
          .add(LineItem('Youth Ticket', childTickets.toString(), youthPrice));
    }
    if (adultTickets > 0) {
      lineItemList
          .add(LineItem("Adult Ticket", adultTickets.toString(), adultPrice));
    }
    if (seniorTickets > 0) {
      lineItemList.add(
          LineItem("Senior Ticket", seniorTickets.toString(), seniorPrice));
    }
    if (lineItemList.isEmpty) {
      showDialog(
          context: context,
          builder: (context) {
            return const AlertDialog(
              title: Text("Please select tickets to purchase"),
              content: Text(
                  "You do not have any tickets selected to purchase. Please choose ticket(s) for the performance."),
            );
          });
      return null;
    }
    final data = SquareData(idemKey, OrderData(api.locationId, lineItemList));
    // 改用await等待请求完成，确保获取到响应后再返回结果
    final response = await http.post(
      Uri.parse("/.netlify/functions/square-payments"),
      body: data.toJson()
    );
    final jsonResponse = jsonDecode(response.body)["payment_link"];
    return Uri.parse(Uri.encodeFull(jsonResponse["url"]));
}

额外移动端注意事项 #

如果修正后仍有问题，检查url_launcher的移动端配置：

• Android：确保AndroidManifest.xml中添加了网络链接的intent过滤，或调用launchUrl时指定mode: LaunchMode.externalApplication
• iOS：确保Info.plist中添加LSApplicationQueriesSchemes，允许打开外部链接

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