Flutter+FireBase上传文件时URL特殊字符被转义问题咨询

DevOps 小满

2026-9-1

问题概述

正常业务流程：用户通过file picker选择pdf/jpeg格式文件导入时，应用会提取文件名展示在卡片的Text组件上；用户保存修改后文件上传至Firebase Storage，Storage内可正确保留文件原始名称，例如user guide.pdf上传后文件名不会发生变化。
异常表现：文件上传完成后，应用获取文件下载URL并存入Firebase数组时，URL内的文件名和原始名称不匹配，空格被转义为%20，变为user%20guide.pdf，该问题已影响应用正常运行，暂未找到禁用该自动转义行为的方法。

相关实现代码片段：

for (int g = 0; g <  List_Adding_New_Attachements.length; g++) {
      final fileName = List_Adding_New_Attachements[g]
          .split('/')
          .last;
      final destination = fileName;

      attachment_Files = FirebaseApi_Upload_Files_To_Storage.uploadFile(
          destination, List_Adding_New_Attachements[g]);
      setState(() {});

      if (attachment_Files == null) return;

解决方法

首先明确：URL中对空格等特殊字符做百分号编码是HTTP URL的标准规范要求，Firebase Storage返回的下载URL默认遵循该规范，没有提供关闭该自动转义的配置项，不需要强行修改URL本身，可通过以下两种方式解决问题：

优先方案：存储时成对保存原始文件名和下载URL
你在文件上传前已经拿到了未转义的原始fileName变量，不需要后续从下载URL中反向解析文件名。上传完成拿到下载URL后，将原始文件名、对应下载URL作为一组数据存入Firebase数组即可，前端展示文件名时直接读取你预先存储的原始文件名字段，完全规避URL转义带来的问题。该方案同时可以覆盖中文、&、?等其他特殊字符转义的同类场景，稳定性最高。
备选方案：对从URL中提取的文件名做解码处理
如果业务逻辑已经固定需要从URL中解析文件名展示，只需要对解析出的文件名部分做URL解码即可，不要修改完整URL（解码完整URL会破坏URL格式导致文件无法访问）。Dart内置了对应的解码方法，示例代码如下：
```
// 从URL中提取到带转义字符的文件名后做解码
final escapedFileName = "user%20guide.pdf";
final originalFileName = Uri.decodeComponent(escapedFileName);
// 解码后即可得到原始文件名 "user guide.pdf"
```

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