Visual Studio 17发布安装程序偶发请求超时失败问题排查

可能原因 #

• HTTP缓存异常：公网服务器的CDN或Web服务器（比如IIS）缓存策略出问题，字体文件的缓存副本损坏或过期后回源失败，网页请求走HTTP缓存触发超时；而FTP直接读取服务器文件系统，不受缓存影响所以能正常下载，缓存的不稳定回收导致成功率随时间波动
• 文件锁定/资源竞争：服务器上的Franklin Gothic Heavy Regular.ttf.deploy被进程占用（比如发布工具残留、IIS工作进程锁文件），HTTP请求无法读取文件，等服务器进程自动回收后恢复，造成时好时坏的情况
• 特殊字符处理不彻底：虽然做了URL编码，但ClickOnce部署清单或服务器的URL解析逻辑仍未处理好空格这类特殊字符，偶发触发解析错误导致超时
• 被动模式取消后的适配问题：取消被动模式后，部分客户端防火墙限制主动模式连接，反而出现不稳定的超时情况

解决方法 #

• 清理HTTP缓存
  • IIS环境：打开IIS管理器找到对应站点，进入「输出缓存」，删除该字体文件的缓存条目；同时给.deploy后缀文件设置禁止缓存或短TTL（比如5分钟），避免缓存脏数据
  • 有CDN的情况：在CDN控制台手动刷新该字体文件的缓存，同时配置.deploy文件的缓存策略为「不缓存」或「每次回源校验」
• 修复部署配置与文件权限
  • 重新发布ClickOnce：在Visual Studio中重新发布，勾选「重新生成部署清单」，确保清单里的字体路径是正确的URL编码格式（比如Franklin%20Gothic%20Heavy%20Regular.ttf.deploy）
  • 检查文件权限与锁定：确认Franklin Gothic Heavy Regular.ttf.deploy的IIS_IUSRS权限正常，用Process Explorer排查是否有进程占用该文件，有则杀掉释放
• 优化网络与服务器配置
  • 恢复被动模式并开放端口：重新启用ClickOnce发布的被动模式，同时在服务器防火墙开放被动模式所需的端口范围（默认50000-65535），避免客户端防火墙拦截主动模式连接
  • 延长IIS连接超时：在站点「高级设置」里把「连接超时」从默认120秒改为300秒，给大文件下载预留足够时间
• 临时规避与监控
  • 添加下载重试逻辑：在应用启动前的部署检查代码中，给超时的文件增加2-3次重试机制
  • 内嵌字体替代：将该字体转换为内嵌资源打包到主程序集，绕开ClickOnce单独下载的逻辑，验证是否为下载环节的问题

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