排查记录：关于每日大赛91快速笔记：下载提示怎么处理这3条够用
在维护比赛资料、题库或资源包时，遇到“下载提示不正常”、“浏览器直接打开而不是下载”或“提示权限/失败”类问题很常见。经过多年实战排查，这里把最实用的三条排查与修复要点整理成速查笔记，三条足够解决90%下载相关的问题，方便直接应用到你的 Google 网站或后台服务上。
一、先看响应——状态码与响应头（最常见且最关键）
- 检查响应状态码：用 curl -I <下载链接> 或浏览器开发者工具的 Network 面板查看返回码。常见问题：
- 404/410：文件不存在或路径错误，先确认文件已上传且路径正确。
- 403：权限受限或防盗链，检查服务器权限或签名。
- 500/502/504：后端错误或网关问题，查看服务器日志。
- 核对关键响应头：
- Content-Disposition: attachment; filename="xxx.pdf" —— 强制浏览器以下载方式处理。
- Content-Type: 应与文件类型匹配（application/pdf、application/zip、application/octet-stream 等）。
- Content-Length: 部分浏览器/下载器依赖此值，缺失或不正确会导致下载中断或提示异常。
- 快速修复示例（Nginx）：
- 添加/修正响应头： addheader Content-Disposition 'attachment; filename="$httpfilename"';
- 设置正确的 MIME 类型：确保 mime.types 中包含所需类型，或在服务端显式设置 Content-Type。
二、前端与浏览器兼容性（链接与编码问题）
- 中文/特殊字符文件名：如果文件名含中文或空格，需对 filename 进行编码。
- 推荐使用 RFC5987 格式： Content-Disposition: attachment; filename*=UTF-8''%E4%B8%AD%E6%96%87.pdf
- 如果不能兼容旧浏览器，也可同时提供 filename 和 filename* 两种写法。
- 链接与协议：
- 确认链接协议一致（HTTPS 页面请求 HTTP 下载会被浏览器阻止为混合内容）。
- 若使用带签名的临时 URL（例如云存储的预签名链接），确认签名没有过期且参数正确编码。
- 前端实现要点：
- 普通 a 标签加上 download 属性可提示下载（但不是万能，跨域或服务器响应头仍主导）。
- 对通过 JS 发起的请求，使用 window.location 或创建隐藏 a 标签并触发 click 更稳定；若通过 fetch 获取二进制并生成 Blob，需处理 MIME 与 filename。
三、服务器、CDN 与安全策略（权限、缓存与防盗链）
- 权限与访问控制：
- 检查文件系统权限（web 用户能读取），或对象存储的访问策略（ACL、Bucket Policy）。
- 若使用后台签名或认证（Cookie、JWT），确认客户端请求包含必要凭证。
- CDN 与缓存：
- CDN 可能缓存错误响应或旧头部，导致下载提示异常。解决办法：清除 CDN 缓存或配置正确的 cache-control。
- 断点续传依赖 Range 支持，确认服务器/CDN 支持 Range 请求，否则部分下载器会失败。
- 安全与防护：
- 防火墙或 WAF 规则可能拦截下载请求，检查日志并放行合法路径。
- 杀毒或浏览器插件可能拦截可疑文件，检查是否文件被标记为危险（尤其是可执行文件）。
速查清单（发布前逐项确认）
- curl -I 检查状态码与响应头（Content-Disposition、Content-Type、Content-Length）。
- 测试中文/空格文件名的下载表现，必要时使用 filename* 编码。
- 验证协议一致性（HTTPS）、签名有效期、CDN 缓存状态与服务器权限。
