如何解决 url_launcher 的 Target of URI doesn't exist 导入错误？

import 'package:url_launcher/url_launcher.dart'; 的写法正确。报错表示 Dart 分析器无法通过当前文件所属项目的包配置找到对应文件。

目前还无法确定具体原因。先检查 pubspec.yaml 的缩进，确认依赖加在支付 SDK 自己的包中，并查看 flutter pub get 是否成功完成。现有信息不足以将问题归因于 Flutter 3.41.9 的版本缺陷。

1. 检查 pubspec.yaml 的缩进

题目中的 YAML 没有显示层级。如果实际文件也是这样，依赖配置就有问题。正确结构如下：

dependencies:
  flutter:
    sdk: flutter

  cupertino_icons: ^1.0.8
  webview_flutter: ^4.13.1
  url_launcher: ^6.3.2

检查时注意：

• flutter、cupertino_icons、webview_flutter 和 url_launcher 都在 dependencies 下。
• sdk: flutter 在 flutter 下。
• 使用空格缩进，不要使用 Tab。

^6.3.2 是版本约束，最终解析到的版本以 pubspec.lock 为准。如果缩进只是在粘贴时丢失，可以继续检查后面的项目。

2. 确认修改的是代码所属包的配置

支付 SDK 项目经常同时包含 SDK 本身和演示应用：

payment_sdk/
├── pubspec.yaml
├── lib/
│   └── payment_modal.dart
└── example/
    ├── pubspec.yaml
    └── lib/
        └── main.dart

如果导入语句位于 payment_sdk/lib/payment_modal.dart，就需要在 payment_sdk/pubspec.yaml 中声明 url_launcher。只把依赖加到 example/pubspec.yaml，不能代替 SDK 自己声明直接依赖。

在 SDK 的 pubspec.yaml 所在目录执行：

flutter pub get
flutter pub deps
flutter analyze

如果演示应用也需要更新依赖，再进入 example 执行：

flutter pub get

使用 Pub workspace 时，需要结合工作区根目录和成员包确定配置位置。直接使用 url_launcher 的成员包仍需声明该依赖。

3. 检查依赖解析是否成功

运行 flutter pub get 后，要查看完整输出，确认依赖是否成功解析，尤其要留意以下错误：

• YAML 格式错误。
• SDK 版本约束不满足。
• 依赖版本冲突。
• 下载失败、网络或证书错误。

如果出现 version solving failed 或下载失败，先解决对应错误。重启 VSCode 无法补齐这些依赖。

flutter pub deps 的输出中应能找到 url_launcher。如果找不到，先检查命令执行目录、修改的 pubspec.yaml 和依赖解析日志。

仅凭 Flutter 3.41.9 这个版本号，无法判断本地环境是否满足完整依赖图的要求。可以运行：

flutter --version
flutter doctor -v

再结合 flutter pub get 的具体报错判断原因，避免直接降级 Flutter 或随意更换插件版本。

4. 检查包映射和缓存文件

依赖成功解析后，普通项目的 .dart_tool/package_config.json 中通常会出现：

"name": "url_launcher"

Pub workspace 的包配置可能位于工作区根目录。

找到该条目后，检查它的 rootUri 和 packageUri。这条导入：

import 'package:url_launcher/url_launcher.dart';

最终需要解析到 url_launcher 包中的：

lib/url_launcher.dart

根据检查结果继续排查：

这里需要的是依赖包提供的文件，不要为了消除错误提示，在项目中手动创建 url_launcher.dart。

确认缓存中的文件缺失或损坏后，再考虑执行：

dart pub cache repair
flutter pub get

其中，dart 应来自与项目一致的 Flutter SDK。缓存修复会重新处理缓存中的包，无需作为常规排查的第一步。

5. 命令行正常时，再处理 VSCode

如果 flutter analyze 已不再报告这条导入错误，但 VSCode 仍显示红线，可以依次操作：

1. 保存 pubspec.yaml 和 Dart 文件。
2. 确认 VSCode 打开了包含项目 pubspec.yaml 的目录。
3. 在命令面板执行 Dart: Restart Analysis Server。
4. 如果仍未恢复，执行 Developer: Reload Window。

还需要确认 VSCode 和终端使用的是同一套 Flutter SDK。安装了多套 Flutter、使用 FVM，或配置了 dart.flutterSdkPath 时，尤其要检查这一点。

已经删除过 pubspec.lock 和 .dart_tool，就不必反复删除。pubspec.lock 控制解析版本，.dart_tool 保存生成的配置。删除它们无法修正依赖声明位置或 SDK 路径不一致的问题，还可能导致依赖版本变化。

6. 修正回调中的变量错误

原代码还有一处与导入错误无关的变量问题，需要在导入恢复后修正：

final theUrl = request.url;
if (await canLaunchUrl(uri)) {

这里声明了 theUrl，片段中却没有定义 uri。后面的日志又使用了 url，可能记录到另一个地址，也可能因变量未定义而报错。

如果要保留所有导航都交给外部应用的行为，可以将回调替换为：

onNavigationRequest: (NavigationRequest request) async {
  final targetUrl = request.url;

  try {
    final uri = Uri.parse(targetUrl);

    if (await canLaunchUrl(uri)) {
      final launched = await launchUrl(
        uri,
        mode: LaunchMode.externalApplication,
      );

      if (!launched) {
        debugPrint('Cannot open URL: $targetUrl');
      }
    } else {
      debugPrint('Cannot open URL: $targetUrl');
    }
  } catch (error) {
    debugPrint('Failed to open URL: $targetUrl; $error');
  }

  return NavigationDecision.prevent;
},

回调中统一使用 targetUrl，并将字符串转换为 API 所需的 Uri。即使预检查通过，实际启动仍可能失败，因此还要检查 launchUrl 的返回值。

支付页面通常也需要在 WebView 中继续加载普通网页。实际接入时，应根据支付协议约定判断哪些导航需要外部打开。需要留在 WebView 中的请求返回：

return NavigationDecision.navigate;

原代码无条件返回 NavigationDecision.prevent，会阻止所有被该回调拦截的导航，即使外部应用未能成功打开。

初始化中的这段代码也需要检查：

..loadRequest(Uri.parse(url));

url 必须已在相应作用域中定义，并包含有效的初始页面地址。

7. 区分导入错误和运行时配置问题

Android 的 <queries>、iOS 的 LSApplicationQueriesSchemes 等配置，影响运行时对 URL scheme 的查询能力。是否需要配置，取决于目标平台、系统版本和使用的 scheme。

这些配置无法解决 Target of URI doesn't exist。先让 Dart 正确解析依赖，再排查 canLaunchUrl 返回 false、外部应用无法启动等运行时问题。canLaunchUrl 返回 false 也不一定表示应用没有安装，平台的查询限制同样可能影响结果。

添加原生插件后，需要停止应用并重新构建，再进行运行验证。Hot Reload 无法完成新增原生插件的接入。

备注：内容仅供参考。