如何排查无错误提示时az storage fs file upload文件未上传问题？

• 检查本地源文件状态

  • 确认文件存在：执行ls -l ./black-violations.1.0.31.txt（Linux/macOS）或dir black-violations.1.0.31.txt（Windows），核对文件名、路径是否和命令里的一致，注意大小写和版本号是否有误。
  • 验证文件权限：Linux/macOS下用ls -l ./black-violations.1.0.31.txt查看当前用户是否有读取权限；Windows右键文件查看「安全」选项卡的权限设置。
  • 检查文件大小：用du -h ./black-violations.1.0.31.txt（Linux/macOS）或dir /s black-violations.1.0.31.txt（Windows）确认文件不是空文件，空文件可能被CLI静默处理。

• 核实目标存储配置

  • 确认文件系统存在：执行az storage fs list --account-name my-account，检查输出中是否包含ddexwhl。
  • 验证目标路径：先手动创建whl目录，执行az storage fs directory create --name whl -f ddexwhl --account-name my-account，再重试上传；也可以尝试直接上传到根目录（--path black-violations.1.0.31.txt），排除路径层级问题。
  • 检查文件名限制：确认文件名没有包含Azure禁止的字符（如\ / : * ? " < > |），虽然当前文件名看起来合规，但可以换个简单文件名测试。

• 启用详细日志定位问题

  • 给上传命令添加--debug参数，输出完整的请求和响应日志：

    az storage fs file upload --source ./black-violations.1.0.31.txt 
      --path whl/black-violations.1.0.31.txt -f ddexwhl 
      --overwrite --account-name my-account --debug
    

    重点查看HTTP状态码、响应内容，排查是否有隐藏的权限不足、配额超标或网络超时问题。
  • 将命令改为单行执行，避免换行导致的参数解析错误：

    az storage fs file upload --source ./black-violations.1.0.31.txt --path whl/black-violations.1.0.31.txt -f ddexwhl --overwrite --account-name my-account
    

• 检查存储账户状态与权限

  • 登录Azure门户确认存储账户my-account状态为「可用」，没有被锁定或配额超标。
  • 验证当前CLI登录账户的权限：执行az role assignment list --assignee <你的用户ID> --scope /subscriptions/<订阅ID>/resourceGroups/<资源组>/providers/Microsoft.Storage/storageAccounts/my-account，确保拥有Storage File Data Contributor及以上权限。
  • 排查网络限制：如果存储账户配置了防火墙或虚拟网络规则，确认当前机器IP在允许列表内，可暂时关闭规则测试上传。

• 手动验证上传结果

  • 执行命令检查目标文件是否存在：

    az storage fs file exists --path whl/black-violations.1.0.31.txt -f ddexwhl --account-name my-account
    

    返回true但看不到文件的话，刷新存储账户页面排除缓存问题；返回false则结合日志继续排查。
  • 用Azure门户或Azure Storage Explorer手动上传该文件，确认是否是CLI本身的问题。

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