Azure Databricks界面上传JAR至DBFS出现Downstream duration timeout错误如何解决

Downstream duration timeout属于Azure前端网关的超时错误，触发原因是Web UI上传链路的请求耗时超过了网关阈值，网络波动、工作区负载过高、旧版UI的超时阈值较低都可能导致该问题，以下是无代码场景下的可行解决方案：

1 更换DBFS UI上传入口 #

Azure Databricks提供新旧两个DBFS管理界面，新界面的上传超时阈值更高：

• 点击左侧菜单栏「目录」，顶部导航下拉选择「DBFS」，进入FileStore/jar路径后点击右上角「上传」按钮重试
• 避免使用旧版「数据」tab下的DBFS上传入口，该入口的超时限制更严格

2 网络与浏览器优化 #

• 切换到浏览器无痕模式登录Databricks工作区重试，排除插件、本地缓存对上传链路的干扰
• 关闭当前网络的VPN、代理服务，或切换到稳定性更高的网络环境，跨区域访问工作区时网络波动是触发该错误的常见原因
• 单次仅上传目标JAR文件，不要同时上传多个文件抢占带宽

3 底层存储直传方案 #

如果以上UI上传方式均失败，可直接访问DBFS对应的底层存储账户上传，全程无代码操作：

• 登录Azure门户，进入对应Databricks工作区所在的资源组，找到工作区关联的ADLS Gen2存储账户（命名通常包含dbws前缀和随机后缀）
• 进入存储账户的「存储浏览器（预览）」页面，依次展开「容器」->dbfs->FileStore->jar路径，直接拖拽本地JAR文件到该路径即可完成上传
• 上传完成后返回Databricks DBFS界面刷新，即可看到对应文件

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