GCP Storage对象下载文件名含URL编码路径问题咨询

我太懂你这种烦躁了——从嵌套目录的存储桶里下载文件，结果默认文件名带了一堆URL编码的路径字符，每次都得手动删改，非公开文件的操作还特别麻烦。下面给你几个实用的解决办法，彻底搞定这个问题：

• 给单个/批量对象设置Content-Disposition元数据
  这是最直接的根治方法，通过这个元数据可以强制指定下载时的文件名：

  • 单个文件操作：在GCP控制台的存储浏览器找到目标文件，进入详情页点击「编辑元数据」，添加键Content-Disposition，值设为attachment; filename="file.exe"（把file.exe换成你实际想要的文件名）。设置完成后再下载，就会直接用这个指定的文件名，不会带路径编码了。
  • 批量文件操作：如果有大量文件需要处理，用gsutil命令行工具效率更高。比如给mybucket/2018/myEXEs目录下的所有exe文件自动设置为自身文件名：

    gsutil -m setmeta -h "Content-Disposition: attachment; filename='$(basename {} )'" gs://mybucket/2018/myEXEs/*.exe
    

    这个命令会自动提取每个文件的基础名称（也就是路径最后一段的文件名）作为下载时显示的名称。

• 生成签名URL时指定文件名
  如果是分享非公开文件用签名URL，可以在生成URL的时候直接指定下载文件名。比如用Python的google-cloud-storage库实现：

  from google.cloud import storage
  from datetime import timedelta
  
  storage_client = storage.Client()
  bucket = storage_client.bucket("mybucket")
  blob = bucket.blob("2018/myEXEs/file.exe")
  
  signed_url = blob.generate_signed_url(
      version="v4",
      expiration=timedelta(minutes=15),
      response_disposition='attachment; filename="file.exe"'
  )
  

  用户通过这个签名URL下载时，会直接使用你指定的文件名，完全不会出现路径编码的问题。

• 设置存储桶默认元数据（适合新上传文件）
  如果你希望后续新上传的文件自动应用规则，可以配置存储桶的默认元数据模板。不过这个方法要注意，它会影响所有新上传的对象，适合有统一命名规则的场景：在GCP控制台的存储桶详情页，找到「默认元数据」选项，添加Content-Disposition键值对。如果需要动态文件名，建议结合上传脚本一起使用，在上传时自动设置对应元数据。

另外，设置好Content-Disposition元数据后，就算直接在存储浏览器里下载非公开文件，也会自动用正确的文件名，不用再手动修改啦。

内容的提问来源于stack exchange，提问作者Aditya Dutta