Flutter WebView中如何绕过App Links，在外部浏览器打开指定URL？

你遇到的核心问题是：已注册为App Links的URL在外部浏览器打开时，会被系统自动跳转回App，形成循环。以下是几种可行的解决方案：

方案1：通过URL参数绕过App Links关联 #

给要打开的首页URL添加一个自定义参数（比如skip_app_link=true），同时让后端配合调整响应逻辑：

• 当URL包含该参数时，后端返回的页面移除App Links相关配置（比如Android的assetlinks.json关联、iOS的apple-app-site-association匹配规则，或页面内的关联meta标签）
• 后端收到参数后重定向到正常首页，此时浏览器打开重定向后的页面时，因为没有App Links关联，不会触发跳转回App

Flutter代码修改示例：

import 'package:url_launcher/url_launcher.dart';

Future<void> openUrlInBrowser(String urlStr) async {
  final Uri originalUrl = Uri.parse(urlStr);
  // 添加跳过App Links的参数
  final Uri modifiedUrl = originalUrl.replace(
    queryParameters: {
      ...originalUrl.queryParameters,
      'skip_app_link': 'true',
    },
  );
  if (!await launchUrl(
    modifiedUrl,
    mode: LaunchMode.externalApplication,
  )) {
    throw Exception('Could not launch $modifiedUrl');
  }
}

方案2：原生平台定制跳转逻辑 #

如果无法修改后端，可以通过Flutter平台通道调用原生代码，强制浏览器打开URL时不触发App Links跳转：

Android端实现（Kotlin） #

在MainActivity.kt中添加MethodChannel逻辑：

import android.content.Intent
import android.net.Uri
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class MainActivity : FlutterActivity() {
    private val CHANNEL = "your.app.package/url_launcher"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "openUrlInBrowser") {
                val url = call.argument<String>("url") ?: run {
                    result.error("INVALID_URL", "URL is null", null)
                    return@setMethodCallHandler
                }
                val intent = Intent(Intent.ACTION_VIEW, Uri.parse(url))
                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
                // 指定浏览器包名，避免系统触发App Links跳转
                intent.setPackage("com.android.chrome")
                try {
                    startActivity(intent)
                    result.success(true)
                } catch (e: Exception) {
                    // 浏览器未安装时回退到默认处理
                    intent.setPackage(null)
                    startActivity(intent)
                    result.success(true)
                }
            } else {
                result.notImplemented()
            }
        }
    }
}

iOS端实现（Swift） #

在AppDelegate.swift中添加MethodChannel逻辑：

import UIKit
import Flutter

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    private let CHANNEL = "your.app.package/url_launcher"

    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        guard let controller = window?.rootViewController as? FlutterViewController else {
            return super.application(application, didFinishLaunchingWithOptions: launchOptions)
        }
        let channel = FlutterMethodChannel(name: CHANNEL, binaryMessenger: controller.binaryMessenger)
        channel.setMethodCallHandler { [weak self] call, result in
            guard call.method == "openUrlInBrowser",
                  let urlString = call.arguments as? String,
                  let url = URL(string: urlString) else {
                result.error("INVALID_URL", "URL is null", nil)
                return
            }
            // 配置打开选项，避免触发App Links跳转
            let options: [UIApplication.OpenExternalURLOptionsKey: Any] = [.openInPlace: true]
            UIApplication.shared.open(url, options: options) { success in
                result.success(success)
            }
        }
        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

Flutter端调用平台通道 #

import 'package:flutter/services.dart';

const MethodChannel _urlLauncherChannel = MethodChannel('your.app.package/url_launcher');

Future<void> openUrlInBrowser(String urlStr) async {
  try {
    await _urlLauncherChannel.invokeMethod('openUrlInBrowser', {'url': urlStr});
  } on PlatformException catch (e) {
    throw Exception('Could not launch $urlStr: ${e.message}');
  }
}

方案3：调整App Links匹配规则 #

如果首页不需要通过App Links跳转，可以直接修改App Links的配置，排除首页路径：

• Android：修改assetlinks.json，只包含需要跳转的路径，排除/home
• iOS：修改apple-app-site-association，在paths字段中添加NOT /home，排除首页路径

这样系统处理首页的App Links时，会直接在浏览器打开，不会跳转至App。

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