jackc/pgx · error

Record incomplete: %w

Error message

Record incomplete: %w

What it means

Error "Record incomplete: %w" thrown in jackc/pgx.

Source

Thrown at pgtype/composite.go:299

type CompositeBinaryScanner struct {
	m *Map
	r *pgio.Reader

	fieldCount int32
	fieldBytes []byte
	fieldOID   uint32
	err        error
}

// NewCompositeBinaryScanner a scanner over a binary encoded composite value.
func NewCompositeBinaryScanner(m *Map, src []byte) *CompositeBinaryScanner {
	r := pgio.NewReader(src)

	// Each field requires at least 8 bytes: 4 for the OID and 4 for the length prefix.
	fieldCount := r.Count(8)
	if err := r.Err(); err != nil {
		return &CompositeBinaryScanner{err: fmt.Errorf("Record incomplete: %w", err)}
	}

	return &CompositeBinaryScanner{
		m:          m,
		r:          r,
		fieldCount: int32(fieldCount),
	}
}

// Next advances the scanner to the next field. It returns false after the last field is read or an error occurs. After
// Next returns false, the Err method can be called to check if any errors occurred.
func (cfs *CompositeBinaryScanner) Next() bool {
	if cfs.err != nil {
		return false
	}

	if cfs.r.Remaining() == 0 {
		return false

View on GitHub (pinned to ec1a0befd2)

When it happens

Trigger: Thrown at pgtype/composite.go:299 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of jackc/pgx@ec1a0befd2 (2026-08-04). Data as JSON: /data/errors/85273c36fc70e6b4.json. Report an issue: GitHub.