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
相关产品推荐
相关产品推荐

