hyperledger/fabric · error

cannot read file part %s from request body

Error message

cannot read file part %s from request body

What it means

This error wraps the error from io.ReadAll when the server could read the file header but failed reading the full contents of the 'config-block' file part from the request body. It is returned as HTTP 400 and indicates the byte stream for the uploaded block was interrupted or unreadable, so the genesis/config block bytes could not be collected for unmarshaling.

Source

Thrown at orderer/common/channelparticipation/restapi.go:455

		h.sendResponseJsonError(resp, http.StatusBadRequest, errors.Errorf("form does not contains part key: %s", FormDataConfigBlockKey))
		return nil
	}

	if len(form.File) != 1 || len(form.Value) != 0 {
		h.sendResponseJsonError(resp, http.StatusBadRequest, errors.New("form contains too many parts"))
		return nil
	}

	fileHeader := form.File[FormDataConfigBlockKey][0]
	file, err := fileHeader.Open()
	if err != nil {
		h.sendResponseJsonError(resp, http.StatusBadRequest, errors.Wrapf(err, "cannot open file part %s from request body", FormDataConfigBlockKey))
		return nil
	}

	blockBytes, err := io.ReadAll(file)
	if err != nil {
		h.sendResponseJsonError(resp, http.StatusBadRequest, errors.Wrapf(err, "cannot read file part %s from request body", FormDataConfigBlockKey))
		return nil
	}

	block := &cb.Block{}
	err = proto.Unmarshal(blockBytes, block)
	if err != nil {
		h.logger.Debugf("Failed to unmarshal blockBytes: %s", err)
		h.sendResponseJsonError(resp, http.StatusBadRequest, errors.Wrapf(err, "cannot unmarshal file part %s into a block", FormDataConfigBlockKey))
		return nil
	}

	return block
}

// Expect a multipart/form-data with a single part, of type file, with key FormDataConfigUpdateEnvelopeKey.
func (h *HTTPHandler) multipartFormDataBodyToEnvelope(params map[string]string, req *http.Request, resp http.ResponseWriter) *cb.Envelope {
	boundary := params["boundary"]
	reader := multipart.NewReader(

View on GitHub (pinned to 2736b63f8f)

Solutions

1. Re-send the request ensuring the full file uploads without interruption
2. Increase h.config.MaxRequestBodySize (General.MaxRequestBodySize in orderer config) if the block exceeds the limit
3. Check and raise proxy/client timeouts and buffering limits for large uploads
4. Retry on flaky network links and verify file integrity (size/checksum) client-side before upload

Example fix

# before: orderer rejects large genesis blocks
# General.MaxRequestBodySize: 10MB
# after
# orderer.yaml
General:
  MaxRequestBodySize: 100MB

blockBytes, err := os.ReadFile(blockPath)
if err != nil || len(blockBytes) == 0 {
    return fmt.Errorf("cannot read block file locally: %w", err)
}
if int64(len(blockBytes)) > maxRequestBodySize {
    return fmt.Errorf("block size %d exceeds server MaxRequestBodySize %d", len(blockBytes), maxRequestBodySize)
}

if err != nil {
    if errors.Is(err, io.ErrUnexpectedEOF) {
        // truncated upload: retry with fresh connection
        return retryUpload(blockBytes)
    }
    return err
}

When it happens

Trigger: POSTing to the join endpoint where io.ReadAll on the opened 'config-block' file part fails — connection reset mid-read, body truncated by MaxBytesReader, or disk/network I/O errors on the server stream.

Common situations: Very large genesis blocks hitting MaxRequestBodySize limits; unstable network between client and orderer; reverse proxy (nginx/envoy) buffering limits cutting the upload; client crash during upload.

Related errors

• cannot open file part %s from request body
• form contains too many parts
• failed to create target folder for connection.json: %s
• error reading input
• error encoding output

AI-assisted analysis of hyperledger/fabric@2736b63f8f (2026-09-04). Data as JSON: /api/errors/437e7b0678f34b94. Report an issue: GitHub.