Databricks挂载Azure Blob存储后无法访问文件 报各类访问异常

所有报错的核心原因是挂载关联的认证配置未正确生效，或路径/参数存在拼写错误，挂载点在UI可见仅代表DBFS中创建了挂载条目，不代表挂载配置可正常连通存储，按以下步骤逐一排查：

1. 优先校验SAS令牌本身有效性 #

SAS令牌错误是这类问题最高发的原因，先脱离挂载逻辑单独验证SAS可用性：

• 检查SAS有效期：确认SAS的生效时间、过期时间覆盖当前操作时间，注意时区偏差导致的SAS未生效/已过期问题
• 检查SAS权限：SAS必须至少授予List、Read权限，缺少列权限时会直接报路径不存在
• 检查SAS网络限制：如果SAS配置了允许IP范围，需将Databricks集群的出口IP、所在VNET网段加入允许列表，否则请求会被判定为匿名访问
• 检查SAS授权范围：确认SAS是针对目标存储账户、目标容器生成的，不是错配了其他存储/容器的SAS
• 验证方式：将SAS令牌配置到本地Azure Storage Explorer中，确认可以正常列出容器内文件、读取CSV内容，排除SAS本身的问题

2. 全链路核对参数拼写 #

从你的报错信息看，存在多处参数不一致的问题，逐项核对：

• 存储账户、容器名一致性：挂载代码source字段中的容器名、存储账户名必须和实际资源名完全一致（全小写，无拼写错误）。你报错中出现的ownbackupsalesforcedevemastercnt容器、ownbackupsalesforcedev存储账户，和示例代码中的mycontainer、myblobstorageaccount不匹配，大概率是实际执行代码时拼写错误
• 配置键一致性：extra_configs中的配置键必须严格遵循fs.azure.sas.<容器名>.<存储账户名>.blob.core.windows.net格式，其中容器名、存储账户名必须和source字段完全一致，任意字符偏差都会导致配置无法被识别
• 访问路径一致性：你第三个报错中访问的路径是/mnt/ownbackupsalesforcemnt/accounts.csv，和示例中挂载点/mnt/mymountpoint完全不符，确认读写文件时使用的路径和你挂载时填写的mount_point完全一致，DBFS路径区分大小写
• 机密值正确性：单独执行dbutils.secrets.get(scope = "你的机密作用域名", key = "你的SAS密钥名")，确认返回值不为空，且Key Vault中存储的SAS没有多余的空格、换行符（输出显示[REDACTED]属于正常打码，不代表读取失败）

3. 清理残留缓存后重新挂载 #

反复卸载重挂载容易在集群节点残留缓存，按以下步骤操作：

1. 执行命令彻底删除旧挂载：

dbutils.fs.unmount("/mnt/mymountpoint")

2. 重启当前Databricks集群，清空节点上的文件系统缓存
3. 用核对无误的参数重新执行挂载：

dbutils.fs.mount(
  source = "wasbs://<正确容器名>@<正确存储账户名>.blob.core.windows.net",
  mount_point = "/mnt/mymountpoint",
  extra_configs = {"fs.azure.sas.<正确容器名>.<正确存储账户名>.blob.core.windows.net":dbutils.secrets.get(scope = "你的机密作用域名", key = "你的SAS密钥名")})

4. 分层验证挂载结果 #

挂载完成后按顺序验证，快速定位问题层级：

1. 先列挂载点根目录：执行dbutils.fs.ls("/mnt/mymountpoint/")，如果能返回你上传的CSV文件和文件夹，说明挂载正常
2. 如果上一步失败，直接在集群配置中写入SAS参数绕过挂载逻辑测试：

spark.conf.set("fs.azure.sas.<正确容器名>.<正确存储账户名>.blob.core.windows.net", dbutils.secrets.get(scope = "你的机密作用域名", key = "你的SAS密钥名"))
dbutils.fs.ls("wasbs://<正确容器名>@<正确存储账户名>.blob.core.windows.net/")

• 如果这步执行成功：说明SAS本身有效，问题出在挂载流程的配置写入环节，重新执行第三步的清理挂载操作即可
• 如果这步执行失败：回到第一步重新检查SAS有效性，同时核对存储账户的网络配置：如果存储账户开启了VNET/IP限制，需要将Databricks所在VNET加入允许列表，或开启存储账户的受信任服务访问，将Azure Databricks加入受信任服务列表

其他易忽略的错误点 #

• 不要混用认证方式：如果使用存储账户访问密钥认证，配置键格式为fs.azure.account.key.<存储账户名>.blob.core.windows.net，和SAS认证的配置键不通用，填错会直接认证失败
• 确认容器真实存在：Blob容器名全局唯一，不要将不存在的容器名写入挂载代码
• 不要在路径中添加多余斜杠：挂载路径、文件访问路径不要出现连续斜杠、后缀斜杠错配的问题

内容的提问来源于stack exchange，提问作者Valkyrja.Kara