How to abort hanging companion uploads?

jdcalvin · February 22, 2023, 5:52pm

Companion is in a state with my tus server where its repeatedly making 0 byte Content-Length PATCH requests for multiple uploads. I’m currently seeing it attempt a single file upload for over 3 hours this way.

Looking for advice, either a companion config or tus config for aborting requests. Also, any information on how this happens in the first place?

We are running companion 4.1.1 from the transloadit provided docker image on EC2.

jdcalvin · February 22, 2023, 6:03pm

Appears that they are all Url uploads

jdcalvin · February 22, 2023, 6:34pm

I found an example earlier in the week. It appears it timed out after 4 hours. The upload never completed, but my tus server stopped receiving PATCH requests for that id.

mifi · February 23, 2023, 3:06am

Hi. Do you have any way to reproduce the problem? e.g. any URL that you can share that will cause Companion to start sending 0 length PATCH requests? Or do you know if there’s any reason why the URL server could have stopped sending data just before the request has finished?

mifi · February 23, 2023, 3:22am

I believe there could be 2 separate problems here:

For some reason, tus-js-client keeps sending 0 length PATCH requests. I would think this is a bug (unless this is an intentional “hack” implemented in order to keep-alive the connection between the client and tusd, but looking at tus-js-client source code, I cannot find such a functionality.)
Companion doesn’t have any timeout when reading the URL. This is because got doesn’t have a timeout by default. Normally this is OK because most servers will time out a request after a while, but for some reason your server is not doing that. I think we should introduce a timeout option in Companion. I will create a PR

jdcalvin · February 23, 2023, 3:27am

No. I’ve had rare instances of it happening in the past but today we saw about 20-30 uploads from multiple customers where the same thing happened. Definitely wouldn’t be the same URL, however companion doesn’t log out the source url and we don’t capture it elsewhere.

You are correct that it is sending 0 byte Content-Length PATCH requests. I opened a question on the tusd repo Rejecting Content-Length 0 · Issue #910 · tus/tusd · GitHub earlier to ask about the possibility of using an option to reject 0 byte requests there.

One other semi-related concern about companion I have is that a user can close a browser window, and companion will continue the upload in the background. Its likely that is what is happening here. Customers are closing the browser rather than canceling via uppy which would trigger a tus DELETE. We do see that happening from time to time on hanging uploads and it resolves the issue for the customer.

mifi · February 23, 2023, 4:02am

BTW did you see the beginning of the companion log, does it stream the file from source to tus, or download it first? e.g. before the uploader.total.progress events, do you see this?

controller.get.provider.size need to download the whole file first
uploader.download fully downloading file

also are you running your companion with COMPANION_STREAMING_UPLOAD=true?

Edit: I can see your file is only about 100kb. Because the default chunk size for companion with tus-js-client is 50mb for “streaming uploads”, it leads me to believe that a 100kb file would be uploaded in a single PATCH, and you would either get a 0% progress or 100%, nothing in between. This means that your upload was indeed most likely fully downloaded (successfully) first, and after the file was downloaded, it gets uploaded to tus (using a File-based stream with a known length so no chunkSize needed). So there’s something that went wrong while the downloaded file was being uploaded to tus, causing it to get stuck in this 0 length PATCH request loop at 99.95%

jdcalvin · February 23, 2023, 4:34am

We do have COMPANION_STREAMING_UPLOAD as true.

We also set COMPANION_CHUNK_SIZE to 5242880 (5mb) and yes, I agree, it’s strange that it would stream part of this and not all. Every instance I saw was for Url uploads, so I wonder if the source url was reporting a length different than the total length.

mifi · February 23, 2023, 5:28am

Unless you have any evidence that counters it, I think your file has been fully downloaded first, before being uploaded to tus. Then it means that the server hasn’t reported an incorrect length because the file has been downloaded first. Background: even when COMPANION_STREAMING_UPLOAD=true, companion will still download the file to hard drive first if the URL is “chunked”, meaning it doesn’t report content-length to companion. This is because some upload destinations need to know the expected total file length first, so we have to download the file first to know the length. So I can only think of some bug happening while the file is being uploaded to tus, either tus-js-client or tusd.

mifi · February 23, 2023, 5:37am

I’m thinking this code might be able to cause a bug:

github.com

tus/tus-js-client/blob/a456406f8e4232db416705952da5ef49a661c7ef/lib/upload.js#L778


      
            if (Number.isNaN(offset)) {
              this._emitHttpError(req, res, 'tus: invalid or missing offset value')
              return
            }
          
          
  this._emitProgress(offset, this._size)
            this._emitChunkComplete(offset - this._offset, offset, this._size)
          
          
  this._offset = offset
          
          
  if (offset === this._size) {
              // Yay, finally done :)
              this._emitSuccess()
              this._source.close()
              return
            }
          
          
  this._performUpload()
          }
          
          
/**

I think it should instead check offset >= this._size, or else it might overshoot if there’s another bug and then it calls this. _performUpload() and keeps on going

Created a PR here:

it would be really nice to find a way to reproduce this problem though

jdcalvin · February 23, 2023, 7:20am

Isn’t that only if it’s unable to determine the size? https://github.com/transloadit/uppy/blob/main/packages/%40uppy/companion/src/server/Uploader.js#L252

Upload is instantiated and size is passed in from getSize here: https://github.com/transloadit/uppy/blob/main/packages/%40uppy/companion/src/server/helpers/upload.js#L9-L13

getSize is ultimately the result of either a HEAD request that can return a Content-Length or a GET request (which I assume fetches the whole file)

github.com

transloadit/uppy/blob/main/packages/@uppy/companion/src/server/helpers/request.js#L146


      
          * @param {boolean} blockLocalIPs
          * @returns {Promise<{name: string, type: string, size: number}>}
          */
          exports.getURLMeta = async (url, blockLocalIPs = false) => {
           async function requestWithMethod (method) {
             const protectedGot = getProtectedGot({ url, blockLocalIPs })
             const stream = protectedGot.stream(url, { method, throwHttpErrors: false })
          
             return new Promise((resolve, reject) => (
               stream
                 .on('response', (response) => {
                   // Can be undefined for unknown length URLs, e.g. transfer-encoding: chunked
                   const contentLength = parseInt(response.headers['content-length'], 10)
                   // If Content-Disposition with file name is missing, fallback to the URL path for the name,
                   // but if multiple files are served via query params like foo.com?file=file-1, foo.com?file=file-2,
                   // we add random string to avoid duplicate files
                   const filename = response.headers['content-disposition']
                     ? contentDisposition.parse(response.headers['content-disposition']).parameters.filename
                     : path.basename(response.request.requestUrl)
          
                   // No need to get the rest of the response, as we only want header (not really relevant for HEAD, but why not)

I can’t tell whether or not the entire contents of the file have been downloaded before the tus server receives requests. I see from tus logs that the full size of the file is recorded as a result of the POST, and in the case of these hanging uploads, the upload stalls just short of the reported size.

I do wonder if in this case the url is reporting an erroneous Content-Length than the actual length. For example the HEAD request returns a length of 1000 but the body size is actually 990. It would result in a tus PATCH Content-Length=900 and Upload-Length=1000 – would it then keep trying to make subsequent PATCH requests since its not considered complete?

mifi · February 23, 2023, 7:38am

I thought about that, but the fact that tus chunk size is much larger than the file size, means that tus wouldn’t start sending PATCH requests until the stream has ended (all bytes received). I did try to setup a node http server script using node.js where I try to feed it more bytes than the reported content-length, however it doesn’t seem to make a difference. So I’m not sure how to reproduce this.

jdcalvin · February 23, 2023, 7:54am

I have an e2e testing environment where I upload to tus from tus-js-client. I see in the tus-js-client code where the total size is determined from options.uploadSize so I tried overwriting it:

const file = Buffer.from('hello world');
file.type = 'text/plain'
const upload = new tus.Upload(
  file, // contents of file to be uploaded
  {
    endpoint: config.tusUrl, // ex: https://tus.url.com/files/
  },
);

upload.options.uploadSize = 10000;
upload.start();

Setting the uploadSize to something higher than the actual file size does result in a constant stream of tus PATCH requests with length 0

mifi · February 23, 2023, 7:57am

Oh great! Now we can get into to fixing the issue

Topic		Replies	Views
Unexpected response while upload chunk Uppy	0	1067	March 29, 2023
How does an uploaded file get from uppy companion to tusd? Uppy	11	721	March 15, 2023
Files does not upload from Uppy using companion Uppy	2	344	January 10, 2024
Inconsistent XHR upload through Uppy Companion Uppy	1	548	December 4, 2019
Problems with "external sources" on upload with XHR Uppy	1	418	March 4, 2025

How to abort hanging companion uploads?

Related topics