如何实现Google Cloud Storage文件直接下载（而非打开新标签）

要让带签名的GCS链接点击后直接下载文件而非在新标签页打开，有两种可靠的实现方式：

方式一：前端通过HTML/JS强制触发下载 #

用<a>标签模拟按钮 #

直接给链接添加download属性，可指定下载后的文件名（可选）：

<a href="https://storage.googleapis.com/{BUCKET NAME}/FILENAME.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=&X-Goog-Date=&X-Goog-Expires=&X-Goog-SignedHeaders=host&X-Goog-Signature=" download="自定义文件名.pdf">下载文件</a>

用<button>按钮配合JS触发 #

如果必须用按钮元素，可通过动态创建<a>标签的方式触发下载：

<button onclick="triggerDownload()">下载文件</button>

<script>
function triggerDownload() {
  const gcsSignedUrl = 'https://storage.googleapis.com/{BUCKET NAME}/FILENAME.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=&X-Goog-Date=&X-Goog-Expires=&X-Goog-SignedHeaders=host&X-Goog-Signature=';
  const downloadLink = document.createElement('a');
  downloadLink.href = gcsSignedUrl;
  downloadLink.download = '自定义文件名.pdf'; // 可选，自定义下载文件名
  document.body.appendChild(downloadLink);
  downloadLink.click();
  document.body.removeChild(downloadLink);
}
</script>

方式二：生成签名链接时添加强制下载参数 #

在生成GCS签名URL的阶段，追加response-content-disposition参数，设置为attachment类型，让服务端直接返回下载响应头：

https://storage.googleapis.com/{BUCKET NAME}/FILENAME.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=&X-Goog-Date=&X-Goog-Expires=&X-Goog-SignedHeaders=host&X-Goog-Signature=&response-content-disposition=attachment; filename="自定义文件名.pdf"

这种方式更可靠，不受前端浏览器跨域或属性限制，所有访问该链接的请求都会直接触发下载。

注意：如果使用方式二，需要确保生成签名URL时将response-content-disposition纳入签名参数范围，否则链接会失效。

内容的提问来源于stack exchange，提问作者Abhijeet Gupta