What causes "reading http response body: %s" in hyperledger/fabric?

Retry the osnadmin command; the error is often transient.

reading http response body: %s

Error message

reading http response body: %s

What it means

readBodyBytes wraps errors from io.ReadAll on the HTTP response body returned by the orderer's osnadmin endpoints. If the connection is interrupted mid-response or the body stream errors, the CLI reports this message with the underlying cause.

Source

Thrown at cmd/osnadmin/main.go:199

	}
	if len(responseBody) != 0 {
		if statusCode == http.StatusOK && outputFile != "" {
			if err := os.WriteFile(outputFile, responseBody, 0o644); err != nil {
				return "", err
			}
		} else {
			if err := json.Indent(&buffer, responseBody, "", "\t"); err != nil {
				return "", err
			}
		}
	}
	return buffer.String(), nil
}

func readBodyBytes(body io.ReadCloser) ([]byte, error) {
	bodyBytes, err := io.ReadAll(body)
	if err != nil {
		return nil, fmt.Errorf("reading http response body: %s", err)
	}
	body.Close()

	return bodyBytes, nil
}

func errorOutput(err error) string {
	return fmt.Sprintf("Error: %s\n", err)
}

func validateBlockChannelID(blockBytes []byte, channelID string) error {
	block := &common.Block{}
	err := proto.Unmarshal(blockBytes, block)
	if err != nil {
		return fmt.Errorf("unmarshalling block: %s", err)
	}

	blockChannelID, err := protoutil.GetChannelIDFromBlock(block)

View on GitHub (pinned to 2736b63f8f)

Solutions

Retry the osnadmin command; the error is often transient.
Check orderer logs for a crash or connection reset.
Verify network connectivity and any proxy/LB between CLI and orderer.
Confirm the orderer is healthy and serving the admin port.

Example fix

// before
resp, err := osnadmin.Fetch(osnURL, ...) // connection drops mid-body
// after
// retry the command and verify orderer health
resp, err := osnadmin.Fetch(osnURL, ...) // on stable connection

Defensive patterns

Strategy: retry

Validate before calling

conn, err := net.DialTimeout("tcp", "orderer:9443", 5*time.Second)
if err != nil {
    return fmt.Errorf("orderer unreachable before fetch: %w", err)
}
conn.Close()

Try / catch

for i := 0; i < 3; i++ {
    resp, err := runOsnadminFetch()
    if err == nil { break }
    if strings.Contains(err.Error(), "reading http response body:") {
        time.Sleep(2*time.Second); continue
    }
    return err
}

Prevention

Check orderer health before issuing commands.
Avoid running admin operations over unstable links or aggressive LB timeouts.
Increase --tlsHandshakeTimeShift if clock skew causes issues.
Monitor orderer logs for connection resets.

When it happens

Trigger: The orderer closes or resets the connection while the response body is being read; TLS handshake time-shift issues; proxy or load balancer truncating the response.

Common situations: Unstable network between CLI and orderer, orderer crash mid-request, timeouts or intermediaries terminating long-running HTTP responses.

Related errors

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