XTLS/Xray-core · error

invalid padding record length: %d

Error message

invalid padding record length: %d

What it means

Error "invalid padding record length: %d" thrown in XTLS/Xray-core.

Source

Thrown at transport/internet/finalmask/xmc/padding.go:232

		written += chunkLength
		if i == 0 {
			clear(buffer[:header.Len()])
		}
	}
	if written != recordLength {
		return fmt.Errorf("padding chunks total %d, want %d", written, recordLength)
	}
	return nil
}

func readPaddingTurn(r io.Reader, turn paddingTurn, prefixLength int) error {
	encodedLength, headerLength, err := readVarintWithLength(r)
	if err != nil {
		return fmt.Errorf("read padding header: %w", err)
	}
	recordLength := int(encodedLength)
	if recordLength < headerLength || recordLength > maxPaddingTurnLength {
		return fmt.Errorf("invalid padding record length: %d", recordLength)
	}
	totalLength := prefixLength + recordLength
	if !paddingTurnAcceptsLength(turn, totalLength) {
		if len(turn.variants) > 0 {
			return fmt.Errorf("padding turn length %d is not an allowed variant", totalLength)
		}
		return fmt.Errorf("padding turn length %d is outside %d-%d", totalLength, turn.minLength, turn.maxLength)
	}

	var buffer [paddingBufferLength]byte
	remaining := recordLength - headerLength
	for remaining > 0 {
		chunkLength := min(remaining, len(buffer))
		if _, err := io.ReadFull(r, buffer[:chunkLength]); err != nil {
			return fmt.Errorf("read padding body: %w", err)
		}
		remaining -= chunkLength
	}

View on GitHub (pinned to 7d214f8b09)

When it happens

Trigger: Thrown at transport/internet/finalmask/xmc/padding.go:232 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of XTLS/Xray-core@7d214f8b09 (2026-08-15). Data as JSON: /api/errors/fc62166dabcf0a20. Report an issue: GitHub.