常見問題

本文介紹在使用ossutil時可能出現的問題及處理方法。

使用-u參數上傳文件時出現skip提示

問題分析：使用-u參數上傳文件的時候，ossutil會將上傳文件和存儲空間（Bucket）內已有文件進行一次比對。若發現上傳的文件與目標Bucket內已有文件同名，且該文件的最后修改時間早于或等于Bucket內已有文件，上傳時會跳過該文件；若該文件的最后修改時間晚于Bucket內已有文件，則重新上傳該文件。所以使用-u參數上傳文件時出現skip提示是正常現象。
解決方案：確認Bucket內文件上傳無問題后忽略該提示。

文件解凍時出現403報錯

問題分析：操作解凍文件的過程中出現403，有以下兩種可能性。

1. 若您是使用子賬號操作文件，可能是子賬號權限不足，無目標文件的操作權限。
2. 您文件內容違禁OSS被封禁了。

解決方案：

1. 子賬號權限不足：增加子賬號權限。
2. 文件內容違禁：刪除或忽略該文件。

使用ls命令查看Bucket無文件，刪除Bucket時報錯

問題分析：使用ls命令列舉Bucket內的文件且未攜帶任何選項時，無法列舉碎片、歷史版本文件（僅存在于開啟過版本控制的Bucket）。若Bucket為非空（即Bucket中存在碎片、歷史版本文件），僅使用rm命令無法刪除該Bucket。
解決方案：

1. 先刪除碎片和歷史版本文件（未開啟過版本控制請忽略），再刪除Bucket。
   1. 刪除碎片和歷史版本文件。
      1. 列舉并刪除碎片：

            ./ossutil ls oss://bucket1 -m
            ./ossutil rm -m oss://bucket1 -r

      2. 列舉并刪除歷史版本文件：

            ./ossutil ls oss://bucket1 --all-versions
            ./ossutil rm oss://bucket1 --all-versions -r

   2. 刪除Bucket。

       ./ossutil rm oss://bucket1 -b

2. 強制刪除Bucket。
   1. 若存儲空間未開啟版本控制，使用如下命令強制刪除Bucket：

       ./ossutil rm oss://bucketname -abrf

   2. 若存儲空間已開啟版本控制，使用如下命令強制刪除Bucket：

       ./ossutil rm oss://bucketname -abrf --all-versions

警告 Bucket及文件被刪除后，無法恢復，請謹慎使用該命令。

文件上傳、下載進度超過100%

問題分析：ossutil在上傳、下載文件時，會自動生成一個名為.ossutil_checkpoint文件夾。當目標文件超過100 MB時，ossutil默認使用斷點續傳上傳或下載目標文件，并將過程中生成的斷點信息文件保存在.ossutil_checkpoint文件夾中。上傳、下載任務完成后，會自動刪除這個文件夾。若單機運行超過一個ossutil實例，且都在進行上傳或下載任務，當其中一個ossutil的任務完成后，會自動刪除.ossutil_checkpoint文件夾，導致其它需要使用斷點續傳的ossutil任務進度超過100%且無法完成。
解決方案：

1. 將當前任務結束，重新開始上傳、下載任務。
2. 在cp命令中加上—checkpoint-dir參數，并手動指定一個與默認checkpoint文件夾不同名的文件夾。例如：

    ./ossutil cp oss://bucket1/myphoto.jpg  /dir  --checkpoint-dir checkpoint

使用ossutil發起單個文件的下載請求，但OSS日志里面有多條請求記錄

問題分析：出現該問題有兩種可能。

1. 請求異常或請求失敗時，ossutil會進行重試操作，默認為10次。
2. 如果您下載的文件超過100 MB，ossutil會使用range方式去請求，即每次請求該文件的部分內容，通過多次請求完成完整文件的下載。因此，超過100 MB的文件下載時也會產生多條請求記錄 。