使用HTML5 download属性无法下载文件，跳转Google Docs问题求助

API 探路者

2026-8-9

问题解决：下载链接被重定向到Google Docs

原因分析

Chrome浏览器对Office文档（如docx）有默认的内置预览机制，当服务器返回的响应头允许浏览器预览时，Chrome会自动将链接重定向到Google Docs在线预览，即便添加了download属性也会被忽略。此外，服务器的Content-Type、Content-Disposition设置也会直接影响浏览器的文件处理逻辑。

解决方案

服务器端配置Content-Disposition响应头（最可靠的多用户场景方案）
在服务器端给docx文件添加Content-Disposition: attachment; filename="myfile.docx"响应头，明确告诉浏览器以附件形式下载文件，优先级高于浏览器的预览逻辑。
示例配置：
Apache（在.htaccess中添加）：
```
<FilesMatch "\.(docx)$">
    Header set Content-Disposition "attachment"
</FilesMatch>
```
Nginx（在对应location块中添加）：
```
add_header Content-Disposition "attachment; filename=$request_filename";
```
修改Content-Type为二进制流
将docx文件的Content-Type从默认的application/vnd.openxmlformats-officedocument.wordprocessingml.document改为application/octet-stream，让浏览器识别为未知二进制文件，直接触发下载。
明确指定download属性的文件名
调整代码为：
```
<a href="../files/uploads/myfile.docx" download="myfile.docx">myfile.docx</a>
```
明确指定文件名可避免部分浏览器的兼容性问题。
禁用Chrome文档预览功能（个人用户临时方案）
在Chrome地址栏输入chrome://settings/content/document，关闭「允许站点预览文件」开关，浏览器将不再自动跳转预览，而是直接下载文件。
排查浏览器扩展
禁用所有下载管理、Office预览类的浏览器扩展，测试是否是扩展修改了链接地址。