Flutter中无法用SharedPreference存储的URL加载InAppWebView问题排查

可能的原因及对应解决方法 #

• SharedPreference 读取时机错误
  SharedPreference 是异步操作，如果在 WebView 初始化时同步读取，大概率还没拿到存储值，导致初始 URL 为空或无效。必须确保读取完成后再初始化 WebView，或者拿到值后主动触发 WebView 重新加载。

  示例代码：

  late String storedUrl;
  InAppWebViewController? _webViewController;
  
  @override
  void initState() {
    super.initState();
    _loadUrlFromPrefs();
  }
  
  Future<void> _loadUrlFromPrefs() async {
    final prefs = await SharedPreferences.getInstance();
    storedUrl = prefs.getString('saved_url') ?? 'https://default-url.com';
    // 拿到值后通知 WebView 加载
    _webViewController?.loadUrl(
      urlRequest: URLRequest(url: Uri.parse(storedUrl))
    );
  }
  

• 存储的 URL 格式不合法
  检查存储的 URL 是否包含完整的 http:// 或 https:// 前缀，有没有多余空格、换行符这类无效字符。可以在读取后打印日志验证：

  print('存储的URL: "$storedUrl"'); // 引号能直观看到首尾是否有空格
  

  如果格式有问题，读取时可以做格式化处理：

  storedUrl = (prefs.getString('saved_url') ?? '').trim();
  if (!storedUrl.startsWith(RegExp(r'https?://'))) {
    storedUrl = 'https://$storedUrl';
  }
  

• WebViewController 未正确持有或更新
  必须持有 InAppWebView 的控制器实例，确保拿到存储 URL 后能调用加载方法。比如：

  @override
  Widget build(BuildContext context) {
    return InAppWebView(
      initialUrlRequest: URLRequest(url: Uri.parse('about:blank')), // 初始空白页
      onWebViewCreated: (controller) {
        _webViewController = controller;
        // 控制器初始化后再读取存储值
        _loadUrlFromPrefs();
      },
    );
  }
  

• SharedPreference 键名不匹配
  检查存储和读取时的键名是否一致（比如存的时候用 'saved_url'，取的时候写成 'save_url'），或者存储时传入了 null 值：

  // 正确的存储代码示例
  Future<void> _saveUrl(String url) async {
    final prefs = await SharedPreferences.getInstance();
    await prefs.setString('saved_url', url);
  }
  

调试建议 #

• 在读写 URL 的地方添加日志，确认数据是否正确：

  // 存储时
  print('正在存储URL: $url');
  // 读取时
  print('读取到的URL: $storedUrl');
  

• 把读取到的 URL 直接赋值给变量测试，排除 WebView 本身的问题：

  String testUrl = storedUrl;
  // 用 testUrl 加载 WebView，看是否能正常显示
  

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