从Azure Blob Storage下载Parquet文件失败：同名文件与文件夹问题

首先得把核心逻辑讲清楚：Azure Blob Storage没有真正意义上的文件夹——我们看到的“文件夹”本质是blob名称的前缀（比如data/parquet/作为前缀，下面的实际Parquet文件是data/parquet/file1.parquet）。当你同时存在一个同名的0B blob（比如直接创建了名为data/parquet的空文件）和一组以data/parquet/为前缀的Parquet blob时，下载工具会优先把这个0B blob识别成“文件夹本身”，下载完这个空文件后，就会报错无法继续获取后续的Parquet内容，这就是你遇到问题的根源。

解决方案：删除0B同名文件，保留前缀对应的Parquet内容即可 #

没错，你只需要移除那个0B的空文件，就能正常下载Parquet内容了。下面是两种常用的删除方式：

方式1：通过Azure Portal操作

• 登录Azure门户，进入你的存储账户
• 切换到「容器」板块，找到对应的Blob容器
• 在文件列表中定位到那个大小为0B的同名文件（注意区分它和带斜杠后缀的“文件夹”条目）
• 选中该文件，点击顶部的「删除」按钮，确认删除即可

方式2：通过Azure CLI命令删除

执行以下命令（替换占位符为你的实际信息）：

az storage blob delete \
  --account-name <你的存储账户名> \
  --container-name <你的Blob容器名> \
  --name <那个0B文件的完整名称>

为什么会出现这种情况？ #

通常是以下两种场景导致的：

• 手动操作时误创建了同名空blob（比如直接在容器根目录新建了parquet文件，而不是通过“新建文件夹”功能生成前缀）
• 某些旧版工具在创建模拟文件夹时，会自动生成一个空的标记blob来标识“文件夹存在”，但后续上传Parquet文件时没有清理这个空blob

后续注意事项 #

• 后续创建模拟文件夹时，尽量使用Azure Portal的「新建文件夹」按钮或工具的前缀创建功能，避免手动创建同名空文件
• 使用Azure Storage Explorer管理Blob时，它会自动处理前缀和blob的显示逻辑，但如果存在同名空文件仍会触发下载异常，记得及时清理这类无效blob

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