You need to enable JavaScript to run this app. Flutter http 0.13.0版本升级后String无法赋值为Uri的错误解决方案
优惠活动
大模型
产品
解决方案
定价
更多

Flutter http 0.13.0版本升级后String无法赋值为Uri的错误解决方案

http 0.13版本String转Uri的解决方法

http 0.13版本做了破坏性参数变更:所有请求类方法(get/post/put/read等)的第一个参数,从之前支持的String类型URL,调整为强制要求Uri类型,因此直接传字符串会触发类型不匹配报错,可通过以下两种方式转换解决:

方式1:直接用Uri.parse()转换已有字符串

这是最快捷的适配方式,适合已经有现成字符串URL的场景:

  • 把原本直接传入请求方法的字符串,用Uri.parse()包裹即可
  • 适配示例:
    // 0.12及更早版本的写法
    await http.get("https://api.example.com/user/info");
    
    // 0.13及以上版本的适配写法
    await http.get(Uri.parse("https://api.example.com/user/info"));
    
  • 该方法会自动完成URL的结构解析、特殊字符转义,覆盖绝大多数日常请求场景

方式2:使用Uri构造器动态生成URI

适合需要动态拼接查询参数、路径的场景,相比手动拼字符串更不容易出现转义错误:

  • 直接通过Uri的命名参数配置scheme、host、path、查询参数,不需要手动拼接字符串
  • 适配示例:
    // 之前手动拼字符串的写法
    final url = "https://api.example.com/search?keyword=$key&page=$page";
    
    // 替换为Uri构造器生成的写法
    final uri = Uri(
      scheme: "https",
      host: "api.example.com",
      path: "/search",
      queryParameters: {
        "keyword": key,
        "page": "$page",
      },
    );
    // 直接把生成的uri传入请求方法
    await http.get(uri);
    

常见避坑提醒

  • 禁止用强转语法把String转成Uri:String和Uri是完全独立的类型层级,写stringUrl as Uri会直接触发运行时类型错误
  • 批量适配技巧:如果项目内有大量历史请求代码,可以全局搜索http.get("/http.post("等匹配模式,统一补全Uri.parse()的包裹逻辑,减少手动修改的工作量
  • 带中文、空格等特殊字符的URL,不要手动做转义拼接,直接交给Uri.parse或者Uri构造器处理即可,原生实现会完全符合URI规范

内容的提问来源于stack exchange,提问作者Kalp Shah

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 10:15:06